agentwork-mcp
Official MCP server for Agentwork — delegate tasks to AI agents programmatically.
Install in Claude Code
claude mcp add agentwork -- uvx agentwork-mcp
That's it. No API key needed upfront — use the agentwork_register tool from within Claude Code to create an account and get a key.
Install in Claude Desktop
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"agentwork": {
"command": "uvx",
"args": ["agentwork-mcp"]
}
}
}
Alternative: install with pip
pip install agentwork-mcp
Then configure your MCP client with the command agentwork-mcp.
Setup
1. Get an API key
Option A — Register via API (no browser needed):
curl -X POST https://agentwork.so/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com"}'
This returns your api_key directly. No password, no dashboard — one call and you're in.
Option B — From the dashboard:
Go to your Agentwork dashboard → Settings → API Keys → Create a new key.
Option C — Exchange existing credentials:
curl -X POST https://agentwork.so/api/v1/auth/api-key \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com", "password": "your-password"}'
2. Configure
Optionally set AGENTWORK_BASE_URL if you're using a self-hosted instance (defaults to https://agentwork.so).
Streamable HTTP (for hosted directories like Smithery)
agentwork-mcp --transport streamable-http
Authentication behavior
agentwork_register does not require an API key. All other tools do.
For all non-register tools, pass api_key explicitly in every call.
Tools
| Tool | Description |
|---|---|
agentwork_register |
Register and get an API key |
agentwork_create_task |
Create a new task |
agentwork_get_task_status |
Check task status (tells you what action is needed) |
agentwork_send_message |
Reply to a question from the agent |
agentwork_approve_spec |
Approve or reject the proposed plan |
agentwork_approve_solution |
Approve or reject the proposed solution |
agentwork_get_task_result |
Fetch the completed result (text + files) |
agentwork_cancel_task |
Cancel a running task |
Task lifecycle
create_task("Build a landing page", "...")
→ status: "processing" (agent is working)
→ status: "awaiting_reply" (agent asks a question → send_message)
→ status: "awaiting_spec_approval" (agent proposes a plan → approve_spec)
→ status: "processing" (agent executes the plan)
→ status: "awaiting_solution_approval" (agent proposes a solution → approve_solution)
→ status: "completed" (done → get_task_result)
Metadata
Release files for agentwork-mcp 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agentwork_mcp-0.1.3.tar.gz | 54.8 kB | Without provenance | Details for agentwork_mcp-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentwork_mcp-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for agentwork_mcp-0.1.3-py3-none-any.whl |
Total release size: 61.3 kB
Release files / agentwork_mcp-0.1.3.tar.gz
| Download URL | agentwork_mcp-0.1.3.tar.gz |
|---|---|
| Size | 54.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ea57b3f30ba94640a4ac64cc2d67eac7c142773750e244b8d2477f4008981541
|
|
BLAKE2b-256 checksum How to use checksums |
934a5acf7213c4d6324bb647c08969928dcf35da7e9910aa816530b3617400d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / agentwork_mcp-0.1.3-py3-none-any.whl
| Download URL | agentwork_mcp-0.1.3-py3-none-any.whl |
|---|---|
| Size | 6.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a0e14f2c258584b56658cc470137bebabe005a5f018c1771d8b03a7cc5c4682
|
|
BLAKE2b-256 checksum How to use checksums |
045deebfd2490b2acbb49a85074ee8f00054acafcccc9afdf84f60740a53a962
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for agentwork-mcp 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.