{
  "markdown": "# Colber\n\n> **Trust, coordination & continuity — for the agent economy.**\n> 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.\n\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n[![@colber/sdk on npm](https://img.shields.io/npm/v/@colber/sdk?label=%40colber%2Fsdk&color=cb3837)](https://www.npmjs.com/package/@colber/sdk)\n[![@colber/mcp on npm](https://img.shields.io/npm/v/@colber/mcp?label=%40colber%2Fmcp&color=cb3837)](https://www.npmjs.com/package/@colber/mcp)\n[![colber-sdk on PyPI](https://img.shields.io/pypi/v/colber-sdk?label=colber-sdk&color=3776ab)](https://pypi.org/project/colber-sdk/)\n\n🌐 **<https://colber.dev>** · 📦 **npm `@colber/*`** · 🐍 **PyPI `colber-sdk`** · 🔌 **MCP-native**\n\n---\n\n## What is Colber?\n\nColber 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):\n\n| Module            | What it does                                                                            |\n| ----------------- | --------------------------------------------------------------------------------------- |\n| **Reputation**    | Cryptographic reputation oracle. DID-based scoring with offline-verifiable attestations (Ed25519 + JCS RFC 8785). |\n| **Memory**        | Persistent semantic memory with vector search, ACLs, and opt-in encryption.             |\n| **Observability** | Distributed A2A tracing and logging. ClickHouse-backed, OpenTelemetry-compatible.       |\n| **Negotiation**   | Multi-party broker with auctions, multi-criteria, and signed settlement (event-sourced). |\n| **Insurance**     | Deliverable guarantees: pricing by reputation, escrow, claim arbitration.               |\n\nPlus an **identity** support service (DID:key + Ed25519 signature verification) used by every module.\n\n> 🏗️ **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.\n\n---\n\n## What's in this repo (open core)\n\nThis 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:\n\n```\napps/\n├── sdk-typescript/   →  npm  @colber/sdk\n├── sdk-python/       →  PyPI colber-sdk\n├── mcp-server/       →  npm  @colber/mcp   (CLI: npx -y @colber/mcp)\n└── site/             →  https://colber.dev (landing source)\n\npackages/\n├── core-types/       →  Public protocol types (errors, envelopes, DIDs)\n├── core-crypto/      →  Client-side crypto helpers (DID:key, Ed25519, JCS canonicalisation)\n├── core-config/      →  Env-var validation utilities (zod schemas)\n└── core-logger/      →  Structured logging utilities (pino + traceId)\n\ntooling/              →  Shared TS / ESLint configs\n.github/              →  Issue + PR templates\ndocs/diagrams/        →  High-level architecture diagrams (Mermaid)\ndocs/MCP_REGISTRIES.md →  Submission templates for Anthropic, Smithery, mcp.so\n```\n\nEverything 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.\n\n### Not in this repo\n\nThe **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.\n\n---\n\n## Quick start\n\n### TypeScript\n\n```bash\nnpm install @colber/sdk\n```\n\n```ts\nimport { ColberClient } from '@colber/sdk';\n\nconst colber = new ColberClient({ baseUrl: 'https://api.colber.dev' });\nconst score = await colber.reputation.score('did:key:z6Mk...');\nconsole.log(score);\n```\n\n### Python\n\n```bash\npip install colber-sdk\n```\n\n```python\nfrom colber import ColberClient\n\ncolber = ColberClient(base_url=\"https://api.colber.dev\")\nscore = colber.reputation.score(\"did:key:z6Mk...\")\nprint(score)\n```\n\n### MCP — Claude Desktop / Claude Code / Cline / Continue\n\nAdd to your MCP client configuration (e.g. `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"colber\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@colber/mcp\"]\n    }\n  }\n}\n```\n\nYou instantly get **27 Colber tools** — reputation lookups, memory search, signed feedback, multi-party negotiations, insurance quotes, and more — directly available to your AI assistant.\n\nSee `apps/mcp-server/README.md` for full configuration options (HTTP transport, custom backend URLs, auth tokens).\n\n---\n\n## Verifying reputation attestations offline\n\nOne 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.\n\n```ts\nimport { ColberClient } from '@colber/sdk';\nimport { verifyAttestation, COLBER_PLATFORM_PUBLIC_KEY } from '@colber/sdk/crypto';\n\nconst colber = new ColberClient({ baseUrl: 'https://api.colber.dev' });\nconst score = await colber.reputation.score('did:key:z6Mk...');\n\nconst valid = await verifyAttestation(score, COLBER_PLATFORM_PUBLIC_KEY);\n// `valid` is true iff the score was actually emitted by Colber.\n```\n\nThe verification logic lives in `packages/core-crypto/` — fully open, auditable, reproducible. You don't have to trust our server to trust the score.\n\n---\n\n## Standards we speak\n\nColber is built on top of open standards rather than reinventing them:\n\n- **MCP** — Model Context Protocol (`@colber/mcp` ships 27 tools)\n- **A2A** — Agent-to-Agent observability\n- **DID** — W3C Decentralized Identifiers (`did:key`, Ed25519 multibase `z6Mk…`)\n- **JCS RFC 8785** — JSON canonicalization for signed payloads\n- **Ed25519** — signatures (via `@noble/ed25519`)\n- **OpenTelemetry** — observability export (planned)\n- **EIP-712** — on-chain signatures (planned for INSURANCE on-chain variant)\n\n---\n\n## Architecture overview\n\n```mermaid\nflowchart TB\n    classDef sdk fill:#F8FAFC,stroke:#475569,color:#0F172A\n    classDef hosted fill:#EFF4FF,stroke:#1E3A8A,color:#1E3A8A\n    classDef this fill:#FFFBEB,stroke:#A16207,color:#78350F\n\n    User[\"🧑 Your agent / app\"]:::sdk\n    SDK[\"@colber/sdk · colber-sdk\"]:::this\n    MCP[\"@colber/mcp\"]:::this\n\n    User --> SDK\n    User --> MCP\n\n    SDK -->|HTTPS| API\n    MCP -->|HTTPS| API\n\n    subgraph hosted[\"Colber hosted platform — colber.dev\"]\n        API[\"api.colber.dev (REST · gRPC)\"]:::hosted\n        REP[\"Reputation\"]:::hosted\n        MEM[\"Memory\"]:::hosted\n        OBS[\"Observability\"]:::hosted\n        NEG[\"Negotiation\"]:::hosted\n        INS[\"Insurance\"]:::hosted\n        ID[\"Identity\"]:::hosted\n        API --> ID\n        API --> REP\n        API --> MEM\n        API --> OBS\n        API --> NEG\n        API --> INS\n    end\n```\n\nFor the high-level functional architecture, see [`docs/diagrams/`](docs/diagrams/).\n\n---\n\n## Local development\n\nThis repo is a Turborepo + pnpm workspace.\n\n### Prerequisites\n\n- Node.js 22+ (`.nvmrc`)\n- pnpm 9.12+ (`corepack enable && corepack prepare pnpm@9.12.3 --activate`)\n\n### Install + checks\n\n```bash\ngit clone https://github.com/Obi49/Colber.git\ncd Colber\npnpm install\npnpm typecheck    # 11/11 green\npnpm test         # 11/11 green\npnpm lint         # 0 errors, 0 warnings\npnpm build        # 7/7 green\n```\n\n### Working on the SDK\n\n```bash\npnpm --filter @colber/sdk dev          # watch build\npnpm --filter @colber/sdk test:watch   # watch tests\n```\n\n### Running the MCP server locally\n\n```bash\npnpm --filter @colber/mcp build\nnode apps/mcp-server/dist/server.js          # stdio (default)\nnode apps/mcp-server/dist/server.js --transport=http --port=14080\n```\n\n### Running the landing locally\n\n```bash\npnpm --filter @colber/site dev\n# → http://localhost:3001\n```\n\n---\n\n## Contributing\n\nWe welcome contributions to the open-core surface — SDKs, MCP server, public types, the website, and documentation. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the workflow (Conventional Commits, DCO, no `--no-verify`).\n\nFor security issues, please follow [`SECURITY.md`](SECURITY.md) — do not file public issues.\n\n---\n\n## License\n\n[Apache License 2.0](LICENSE) — see [`NOTICE`](NOTICE) for attribution and project history (the project was previously named *AgentStack*, then *Praxis*, before being renamed *Colber* in May 2026).\n\nThe hosted services on `colber.dev` are operated under separate commercial terms; using them is subject to the Colber Terms of Service (link forthcoming).\n\n---\n\n## Author\n\n**Johan / Colber** — `dof1502.mwm27@gmail.com`\n\n🌐 <https://colber.dev> · 🐙 <https://github.com/Obi49/Colber>\n",
  "bytes": 8942,
  "sha": "8e8d8d8cadb28a6c73f1d3529be95ff95ac838d7011f11d23bf49e0789cabee6",
  "repo_slug": "obi49/colber",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_obi49_colber_mcp_092073ac/readme"
}