Colber MCP

@colber/mcp

Official Model Context Protocol (MCP) server for Colber — exposes the 5 Colber modules (reputation, memory, observability, negotiation, insurance) plus the agent-identity service as MCP tools to any compatible AI agent.

Plug Colber into Claude Desktop, Claude Code, Cline, Continue, or any other MCP-aware client and your agent immediately gains the ability to negotiate, insure deals, share memory, push observability data, and check on-chain-grade reputation — all behind a single tool surface.

What is Colber?

Colber is the trust, coordination & continuity layer for the agentic economy. While payment rails like MoonPay, Coinbase x402, or Nevermined handle the money, Colber gives autonomous agents the primitives they need to trust each other, negotiate, guarantee deliverables, trace interactions and remember across sessions.

This package is the official MCP gateway. It runs as a thin process that translates MCP tools/call requests into HTTP calls against the Colber backend services.

Quick start

1. Claude Desktop

Add to your MCP config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{

"mcpServers": { "colber": { "command": "npx", "args": ["-y", "@colber/mcp"], "env": { "COLBER_BASE_URLS": "{\"identity\":\"https://api.colber.dev/identity\",\"reputation\":\"https://api.colber.dev/reputation\",\"memory\":\"https://api.colber.dev/memory\",\"observability\":\"https://api.colber.dev/observability\",\"negotiation\":\"https://api.colber.dev/negotiation\",\"insurance\":\"https://api.colber.dev/insurance\"}", "COLBER_AUTH_TOKEN": " " } } } }

Restart Claude Desktop. The 27 Colber tools appear in the tool tray.

2. Claude Code

claude mcp add colber npx -- -y @colber/mcp

Or edit ~/.claude.json directly:

{

"mcpServers": { "colber": { "command": "npx", "args": ["-y", "@colber/mcp"] } } }

3. Cline

Edit mcp_settings.json (path varies by platform — see Cline docs):

{

"mcpServers": { "colber": { "command": "npx", "args": ["-y", "@colber/mcp"], "env": { "COLBER_BASE_URLS": "{...same JSON map as above...}" } } } }

4. Continue

Edit ~/.continue/config.yaml (or the equivalent mcpServers.yaml):

mcpServers:

• name: colber command: npx args:
• -y
• '@colber/mcp' env: COLBER_BASE_URLS: '{"identity":"https://api.colber.dev/identity","reputation":"https://api.colber.dev/reputation","memory":"https://api.colber.dev/memory","observability":"https://api.colber.dev/observability","negotiation":"https://api.colber.dev/negotiation","insurance":"https://api.colber.dev/insurance"}'

Available tools (27)

Tool names use the colber_ _ convention to avoid collisions with other MCP servers a user might have installed. Inputs are validated server-side via Zod; errors are returned as MCP isError: true content with a structured payload (code, message, status, details, traceId).

Identity (3)

Reputation (4)

Memory (4)

Observability (8)

Negotiation (4)

Insurance (4)

Configuration

A complete example lives in .env.example.

HTTP transport

For shared / cloud deployments, run the Streamable HTTP transport instead:

npx @colber/mcp --transport=http --port=14080

The server then exposes:

• POST /mcp — client → server JSON-RPC frames (the SDK responds inline, either as JSON or as an SSE stream depending on content negotiation).
• GET /mcp — opens the standalone server → client SSE stream for out-of-band notifications. Both directions require an Mcp-Session-Id header; clients receive their session id in the response of the initial initialize POST.
• GET /healthz — health probe ({ status: "ok", tools: 27 }).

Local development

pnpm install

pnpm --filter @colber/mcp typecheck pnpm --filter @colber/mcp test pnpm --filter @colber/mcp build node apps/mcp-server/dist/server.js

Docker

docker build -t colber/mcp:0.1.0 -f apps/mcp-server/Dockerfile .

docker run --rm -p 14080:14080 \ -e COLBER_BASE_URLS='{"identity":"https://api.colber.dev/identity","reputation":"https://api.colber.dev/reputation","memory":"https://api.colber.dev/memory","observability":"https://api.colber.dev/observability","negotiation":"https://api.colber.dev/negotiation","insurance":"https://api.colber.dev/insurance"}' \ colber/mcp:0.1.0

License

Apache-2.0 — see the LICENSE file at the repo root.

Links

• Colber — official site.
• GitHub repository.
• Model Context Protocol spec.
• Anthropic MCP TypeScript SDK.