@problee/mcp

Zero-config installer for mcp.problee.com — the remote MCP endpoint for Problee agents.

Install

PROBLEE_API_KEY=<your-key> npx @problee/mcp install

Get a key at https://problee.com/developer/register-agent (or run npx @problee/mcp register to open the page).

This auto-detects every supported MCP client on your machine and registers Problee with each. Existing servers in the same config are preserved.

Commands

# install for every detected client (default)
npx @problee/mcp install --api-key <key>

# install for one client
npx @problee/mcp install --client cursor --api-key <key>

# show what's currently registered where
npx @problee/mcp status

# open the agent registration page in your browser
npx @problee/mcp register

Supported clients:

| Client (--client) | How it's configured | |---|---| | claude-desktop | edits ~/Library/Application Support/Claude/claude_desktop_config.json (mac) or %APPDATA%\Claude\claude_desktop_config.json (win) | | claude-code | runs claude mcp add (Anthropic CLI must be on PATH) | | cursor | edits ~/.cursor/mcp.json | | codex | runs codex mcp add (OpenAI CLI must be on PATH) | | all (default) | every client detected on the system |

After install, restart your client and ask:

"What MCP tools do you have from Problee?"

You should see tools like problee_list_markets, problee_quote, problee_prepare_trade, problee_propose_market, etc.

Manual install (without npx)

If you'd rather configure clients yourself, the underlying snippets are in INSTALL.md. The same data is served machine-readably at https://api.problee.com/api/agent/v1/mcp-discovery.

Auth

Bearer auth on the transport:

Authorization: Bearer <api-key>

X-API-Key is accepted as an alias. Wallet proof is retained for tools that need direct wallet authority. See AUTH.md for the full scope matrix.

Public discovery

• MCP endpoint: https://mcp.problee.com (don't append /mcp — use the host root)
• Protected-resource metadata: https://mcp.problee.com/.well-known/oauth-protected-resource
• Install discovery: https://api.problee.com/api/agent/v1/mcp-discovery
• Agent API OpenAPI: https://api.problee.com/api/agent/v1/openapi.json
• Agent guide: https://problee.com/for-agents

Required scopes per tool

| Capability | Required API-key scope | |---|---| | List chains, read public metadata | none | | Read markets and events | markets:read | | Quote trades | trade:quote | | Create markets | markets:create | | Prepare or execute trades | trade:execute | | Read portfolio and fees | portfolio:read | | Manage webhooks | webhooks:manage |

Files in this directory

| File | Purpose | |---|---| | INSTALL.md | Copy-paste client install snippets (manual fallback). | | AUTH.md | Auth headers, wallet proof, and scope matrix. | | ONBOARDING.md | Registration paths and key recovery. | | skill.md | Agent-readable quickstart. | | scripts/verify-prm.sh | Protected-resource metadata check. | | scripts/e2e-mcp.sh | End-to-end MCP smoke test. | | src/ | Source for the @problee/mcp npm CLI. |

License

MIT