# Wharf

> An MCP (Model Context Protocol) server that exposes the Anthropic Managed Agents API as a set of tools. Connect it from any MCP-compatible client — Claude.ai, Claude Desktop, Claude Code — to deploy, query, update, and archive long-running Managed Agents from inside a conversation. Runs as a single Cloudflare Worker. Stateless by design.

Key facts:

- Project name: Wharf
- Repository: https://github.com/abduljaleel/artifact-to-agent-mcp
- License: MIT
- Runtime: Cloudflare Workers (`nodejs_compat`)
- Language: TypeScript
- MCP endpoint path: `/wharf`
- Server descriptor: `GET /` returns JSON with tool list
- Health: `GET /health`
- Auth (optional): `MCP_AUTH_KEY` via `?key=`, `x-mcp-key`, or `Authorization: Bearer`
- Default model: `claude-sonnet-4-6`
- Default toolset: `agent_toolset_20260401` bundle (bash, read, write, edit, glob, grep, web_fetch, web_search)

## Tools

- `deploy_agent` — Create a Managed Agent and a cloud environment. Returns `agent_id` and `environment_id`.
- `agent_query` — Send a message to an agent. Returns a `session_id` immediately. Does not block on the agent's response.
- `poll_response` — Check a session and return the agent's output, or `running` if still working.
- `agent_status` — Inspect an agent's configuration and optionally a session's state.
- `list_agents` — List agents on the Anthropic account.
- `update_agent` — Change model, tools, system prompt, name, or description of an existing agent.
- `delete_agent` — Archive (soft-delete) an agent.

The `agent_query` / `poll_response` split is deliberate: Managed Agents can run for minutes, while edge Workers time out in seconds. Fire, forget, poll.

## Docs

- [README](https://github.com/abduljaleel/artifact-to-agent-mcp/blob/main/README.md): install, deploy, connect, full tool reference
- [Landing page](https://abduljaleel.github.io/artifact-to-agent-mcp/): overview and quick start
- [Source — MCP server](https://github.com/abduljaleel/artifact-to-agent-mcp/blob/main/src/index.ts): tool definitions and Worker routing
- [Source — Anthropic client](https://github.com/abduljaleel/artifact-to-agent-mcp/blob/main/src/anthropic-client.ts): the thin REST wrapper around `/v1/agents`, `/v1/environments`, `/v1/sessions`

## Connect

Add as a custom connector in Claude.ai (Settings → Connectors → Add custom connector), URL `https://<your-worker>.workers.dev/wharf`. If `MCP_AUTH_KEY` is set, append `?key=<your-key>`.

## Optional

- [MIT license](https://github.com/abduljaleel/artifact-to-agent-mcp/blob/main/README.md#license)
- [Model Context Protocol](https://modelcontextprotocol.io): the protocol Wharf implements