Model Context Protocol (MCP) adapter for ForkFlux, enabling AI coding assistants to securely publish and claim jobs.
Project description
ForkFlux MCP Server
Model Context Protocol (MCP) server for ForkFlux, the coordination bus that lets isolated AI coding agents publish, claim, and close structured handoff jobs.
ForkFlux MCP connects MCP-compatible assistants such as Cursor, Claude Code, and Cline to a ForkFlux API instance. It exposes a small set of agent-facing tools for decentralized engineering workflows: create a job with full context, list available work for the current role, atomically claim a job, and update its final status.
Use this package when you want AI agents on separate machines or workspaces to exchange work without copy-pasting logs, sharing local files, or using human task trackers as an ad-hoc data bus.
What it provides
forkflux_create_job— publish a structured handoff job with constraints, context, artifacts, priority, and target role.forkflux_list_jobs— list jobs available in the shared ForkFlux job pool.forkflux_job_details— retrieve full details for a specific job by ID.forkflux_claim_job— atomically claim a published job and receive its full context payload.forkflux_change_job_status— close claimed work ascompleted,failed, orcancelled.
Requirements
- Python 3.12+
- A running ForkFlux API endpoint
- A ForkFlux API key for the agent using this MCP server
Configuration
Set these environment variables before starting the server:
export FORKFLUX_API_URL="http://localhost:8000/api/v1"
export FORKFLUX_API_KEY="your-agent-api-key"
License
Apache-2.0. See the project repository for full license details.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file forkflux_mcp-0.2.0.tar.gz.
File metadata
- Download URL: forkflux_mcp-0.2.0.tar.gz
- Upload date:
- Size: 9.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.27 {"installer":{"name":"uv","version":"0.11.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d60773a0ea69150403bcaf7843304e0f9441664fa4a7841b0aeaaea9725ba316
|
|
| MD5 |
26eba0597ce0652001ff15442ea5f148
|
|
| BLAKE2b-256 |
7e9c3febc27a1dc42c441b33e93602c0fb4936be54bb8ef2c601b316b9c26e39
|
File details
Details for the file forkflux_mcp-0.2.0-py3-none-any.whl.
File metadata
- Download URL: forkflux_mcp-0.2.0-py3-none-any.whl
- Upload date:
- Size: 10.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.27 {"installer":{"name":"uv","version":"0.11.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ea7040dec22428edcecf034bbd2a300532a0f6e6439d9f39828704a393b9c949
|
|
| MD5 |
5181d73747d31afad430e2e103b51bb0
|
|
| BLAKE2b-256 |
c0b0154de90990a447fb36cc21b912e8c3c5370d77740dad16e6a715b6d2fcbb
|
