Skip to content

Connect an MCP client

EdgeFetch speaks the Model Context Protocol in two ways.

The client starts edgefetch mcp as a child process. Nothing listens on a port.

Terminal window
edgefetch install-mcp # configures Claude Desktop and Cursor

For any other client, add a stdio server that runs edgefetch with the argument mcp. In the common JSON format:

{
"mcpServers": {
"edgefetch": {
"command": "edgefetch",
"args": ["mcp"]
}
}
}

For Claude Code:

Terminal window
claude mcp add edgefetch -- edgefetch mcp

A deployed hub serves MCP at https://<your-hub>/mcp, using OAuth 2.1 with PKCE or a bearer token. Point your client at that URL. Dynamic client registration accepts loopback redirect URIs by default. Allow other hosts with OAUTH_REDIRECT_ALLOWLIST.

The worker image can also run the stdio server:

Terminal window
docker run -i --rm ghcr.io/bartrumb/edgefetch-agent:2.5.2 mcp

See the tools reference for what your agent can call.