io.github.Obi49/colber-mcp

Official

by Obi49 · Python

Trust + coordination infrastructure for the agent economy. 27 tools across 6 Colber modules.

Infrastructure tools for agent coordination and trust with 27 tools across marketplace modules.

Colber

Trust, coordination & continuity — for the agent economy. Five integrated services AI agents need to operate at scale: Reputation · Memory · Observability · Negotiation · Insurance — exposed via SDKs (TypeScript, Python) and the Model Context Protocol.

🌐 https://colber.dev · 📦 npm @colber/* · 🐍 PyPI colber-sdk · 🔌 MCP-native

What is Colber?

Colber is the infrastructure layer of trust, coordination and continuity for the agent economy. The hosted platform at https://colber.dev exposes five integrated capabilities through one consistent surface (REST · gRPC · MCP):

Module	What it does
Reputation	Cryptographic reputation oracle. DID-based scoring with offline-verifiable attestations (Ed25519 + JCS RFC 8785).
Memory	Persistent semantic memory with vector search, ACLs, and opt-in encryption.
Observability	Distributed A2A tracing and logging. ClickHouse-backed, OpenTelemetry-compatible.
Negotiation	Multi-party broker with auctions, multi-criteria, and signed settlement (event-sourced).
Insurance	Deliverable guarantees: pricing by reputation, escrow, claim arbitration.

Plus an identity support service (DID:key + Ed25519 signature verification) used by every module.

🏗️ Status — v1 shipped. All five modules + identity are live on https://colber.dev, end-to-end tested (23/23 green), with 27 MCP tools published.

What's in this repo (open core)

This repository is the public open-core of Colber. It contains the code you need to integrate with Colber from your own agent, plus the public protocol contract:

code

apps/
├── sdk-typescript/   →  npm  @colber/sdk
├── sdk-python/       →  PyPI colber-sdk
├── mcp-server/       →  npm  @colber/mcp   (CLI: npx -y @colber/mcp)
└── site/             →  https://colber.dev (landing source)

packages/
├── core-types/       →  Public protocol types (errors, envelopes, DIDs)
├── core-crypto/      →  Client-side crypto helpers (DID:key, Ed25519, JCS canonicalisation)
├── core-config/      →  Env-var validation utilities (zod schemas)
└── core-logger/      →  Structured logging utilities (pino + traceId)

tooling/              →  Shared TS / ESLint configs
.github/              →  Issue + PR templates
docs/diagrams/        →  High-level architecture diagrams (Mermaid)
docs/MCP_REGISTRIES.md →  Submission templates for Anthropic, Smithery, mcp.so

Everything in this repo is Apache-2.0. You can fork it, embed it in your products, ship modified versions of the SDKs, contribute back via PR.

Not in this repo

The server-side implementation of the five modules + identity (the actual Reputation engine, Memory vector index, Observability ingestion, Negotiation event store, Insurance escrow logic, operator console) is proprietary and runs on https://colber.dev. To use it, you call the hosted endpoints from the SDKs or the MCP server. This is the standard open-core model used by Stripe, Datadog, Auth0.

Quick start

TypeScript

bash

npm install @colber/sdk

import { ColberClient } from '@colber/sdk';

const colber = new ColberClient({ baseUrl: 'https://api.colber.dev' });
const score = await colber.reputation.score('did:key:z6Mk...');
console.log(score);

Python

bash

pip install colber-sdk

python

from colber import ColberClient

colber = ColberClient(base_url="https://api.colber.dev")
score = colber.reputation.score("did:key:z6Mk...")
print(score)

MCP — Claude Desktop / Claude Code / Cline / Continue

Add to your MCP client configuration (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

json

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

You instantly get 27 Colber tools — reputation lookups, memory search, signed feedback, multi-party negotiations, insurance quotes, and more — directly available to your AI assistant.

See apps/mcp-server/README.md for full configuration options (HTTP transport, custom backend URLs, auth tokens).

Verifying reputation attestations offline

One of Colber's strongest properties: every reputation score comes with a cryptographic attestation that can be verified without contacting Colber, using only the platform's public key.

import { ColberClient } from '@colber/sdk';
import { verifyAttestation, COLBER_PLATFORM_PUBLIC_KEY } from '@colber/sdk/crypto';

const colber = new ColberClient({ baseUrl: 'https://api.colber.dev' });
const score = await colber.reputation.score('did:key:z6Mk...');

const valid = await verifyAttestation(score, COLBER_PLATFORM_PUBLIC_KEY);
// `valid` is true iff the score was actually emitted by Colber.

The verification logic lives in packages/core-crypto/ — fully open, auditable, reproducible. You don't have to trust our server to trust the score.

Standards we speak

Colber is built on top of open standards rather than reinventing them:

MCP — Model Context Protocol (@colber/mcp ships 27 tools)
A2A — Agent-to-Agent observability
DID — W3C Decentralized Identifiers (did:key, Ed25519 multibase z6Mk…)
JCS RFC 8785 — JSON canonicalization for signed payloads
Ed25519 — signatures (via @noble/ed25519)
OpenTelemetry — observability export (planned)
EIP-712 — on-chain signatures (planned for INSURANCE on-chain variant)

Architecture overview

mermaid

flowchart TB
    classDef sdk fill:#F8FAFC,stroke:#475569,color:#0F172A
    classDef hosted fill:#EFF4FF,stroke:#1E3A8A,color:#1E3A8A
    classDef this fill:#FFFBEB,stroke:#A16207,color:#78350F

    User["🧑 Your agent / app"]:::sdk
    SDK["@colber/sdk · colber-sdk"]:::this
    MCP["@colber/mcp"]:::this

    User --> SDK
    User --> MCP

    SDK -->|HTTPS| API
    MCP -->|HTTPS| API

    subgraph hosted["Colber hosted platform — colber.dev"]
        API["api.colber.dev (REST · gRPC)"]:::hosted
        REP["Reputation"]:::hosted
        MEM["Memory"]:::hosted
        OBS["Observability"]:::hosted
        NEG["Negotiation"]:::hosted
        INS["Insurance"]:::hosted
        ID["Identity"]:::hosted
        API --> ID
        API --> REP
        API --> MEM
        API --> OBS
        API --> NEG
        API --> INS
    end

For the high-level functional architecture, see docs/diagrams/.

Local development

This repo is a Turborepo + pnpm workspace.

Prerequisites

Node.js 22+ (.nvmrc)
pnpm 9.12+ (corepack enable && corepack prepare pnpm@9.12.3 --activate)

Install + checks

bash

git clone https://github.com/Obi49/Colber.git
cd Colber
pnpm install
pnpm typecheck    # 11/11 green
pnpm test         # 11/11 green
pnpm lint         # 0 errors, 0 warnings
pnpm build        # 7/7 green

Working on the SDK

bash

pnpm --filter @colber/sdk dev          # watch build
pnpm --filter @colber/sdk test:watch   # watch tests

Running the MCP server locally

bash

pnpm --filter @colber/mcp build
node apps/mcp-server/dist/server.js          # stdio (default)
node apps/mcp-server/dist/server.js --transport=http --port=14080

Running the landing locally

bash

pnpm --filter @colber/site dev
# → http://localhost:3001

Contributing

We welcome contributions to the open-core surface — SDKs, MCP server, public types, the website, and documentation. See CONTRIBUTING.md for the workflow (Conventional Commits, DCO, no --no-verify).

For security issues, please follow SECURITY.md — do not file public issues.

License

Apache License 2.0 — see NOTICE for attribution and project history (the project was previously named AgentStack, then Praxis, before being renamed Colber in May 2026).

The hosted services on colber.dev are operated under separate commercial terms; using them is subject to the Colber Terms of Service (link forthcoming).

Author

Johan / Colber — dof1502.mwm27@gmail.com

🌐 https://colber.dev · 🐙 https://github.com/Obi49/Colber

Install

Configuration

Environment variables

COLBER_BASE_URLS

Optional JSON map of Colber service base URLs. Defaults to local ports 14001/14011/14021/14031/14041/14051. For the hosted Colber API, use api.colber.dev path-based URLs.

COLBER_AUTH_TOKENsecret

Optional bearer token forwarded to the backend services. Leave empty for unauthenticated local development.

COLBER_LOG_LEVEL

pino log level for stderr output (stdout is reserved for MCP JSON-RPC). One of: trace, debug, info, warn, error. Defaults to info.

claude_desktop_config.json

{
  "mcpServers": {
    "colber-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@colber/mcp@0.1.1"
      ],
      "env": {
        "COLBER_BASE_URLS": "<YOUR_COLBER_BASE_URLS>",
        "COLBER_AUTH_TOKEN": "<YOUR_COLBER_AUTH_TOKEN>",
        "COLBER_LOG_LEVEL": "<YOUR_COLBER_LOG_LEVEL>"
      }
    }
  }
}