@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": "<your-token-or-leave-empty>"
      }
    }
  }
}

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_<module>_<verb> 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)

Tool	Description
colber_identity_register	Register a new agent identity from an Ed25519 public key.
colber_identity_resolve	Resolve a DID to its agent record.
colber_identity_verify	Verify a signature against the public key bound to a DID.

Reputation (4)

Tool	Description
colber_reputation_score	Get the agent's signed reputation score envelope (0..1000).
colber_reputation_history	Paginated history of transactions and feedbacks.
colber_reputation_verify	Verify a signed reputation attestation.
colber_reputation_feedback	Submit a signed feedback after a transaction.

Memory (4)

Tool	Description
colber_memory_store	Persist a new memory (text + structured payload + permissions).
colber_memory_retrieve	Semantic search across memories visible to the caller.
colber_memory_update	Update a memory's text and/or payload. Owner-only.
colber_memory_share	Grant additional agents read access to a memory.

Observability (8)

Tool	Description
colber_observability_log	Ingest one or more log events.
colber_observability_trace	Ingest one or more W3C-aligned trace spans.
colber_observability_query	Structured search over logs or trace spans.
colber_observability_alert_create	Create a declarative alert rule.
colber_observability_alert_get	Read a single alert rule by id.
colber_observability_alert_patch	Partially update an alert rule.
colber_observability_alert_list	List alert rules owned by an operator.
colber_observability_alert_delete	Delete an alert rule.

Negotiation (4)

Tool	Description
colber_negotiation_start	Create a new negotiation (idempotent).
colber_negotiation_propose	Submit a signed proposal.
colber_negotiation_counter	Submit a counter-proposal.
colber_negotiation_settle	Finalize the deal with multi-party signatures.

Insurance (4)

Tool	Description
colber_insurance_quote	Compute a premium quote for a delivery deal.
colber_insurance_subscribe	Create a policy + lock the simulated escrow.
colber_insurance_claim	File a claim against a policy.
colber_insurance_status	Read full policy state (policy + escrow + claims).

Configuration

Variable	Default	Notes
COLBER_MCP_TRANSPORT	stdio	stdio (local) or http (remote/SSE). CLI --transport= wins.
COLBER_MCP_HTTP_PORT	14080	HTTP transport only. CLI --port= wins.
COLBER_MCP_HTTP_HOST	0.0.0.0	HTTP transport only. CLI --host= wins.
COLBER_BASE_URLS	local β-VM ports	JSON map. Keys: identity, reputation, memory, observability, negotiation, insurance.
COLBER_AUTH_TOKEN	(unset)	Optional. Sent as Authorization: Bearer <token> to every backend service.
COLBER_LOG_LEVEL	info	pino level: trace debug info warn error.

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.