# Bcontext

The context layer for the AI-first company. Typed knowledge graph + RAG + agent-writeable endpoints.

## Discovery

- https://bcontext.dev/.well-known/agents.json — capabilities, scopes, endpoints, MCP URL

## Authentication

All API and MCP calls require a workspace-scoped bearer token:

    Authorization: Bearer bctx_live_<43chars>

Tokens are issued from the Bcontext workspace settings → Tokens. Each token belongs to one workspace; scope checks gate per-operation.

## Examples

Search a workspace via RAG:

    curl -X POST 'https://bcontext.dev/api/agents/context' \
      -H 'Authorization: Bearer bctx_live_…' \
      -H 'Content-Type: application/json' \
      -d '{"workspace":"my-ws","query":"open auth decisions","k":6}'

Propose batched writes (idempotent):

    curl -X POST 'https://bcontext.dev/api/agents/write' \
      -H 'Authorization: Bearer bctx_live_…' \
      -H 'Idempotency-Key: agent-42-batch-7' \
      -H 'Content-Type: application/json' \
      -d '{"workspace":"my-ws","ops":[{"op":"create","node":{"title":"New ADR","kind":"adr","parent_id":null}}]}'

## MCP

Streamable HTTP MCP server at https://bcontext.dev/mcp. Add to Claude Code / Cursor / Claude Desktop mcp.json with the same bearer token.

## Limits

- Read scopes: 120 req/min per token
- Write scopes: 60 req/min
- Chat: 30 req/min
- 429 Retry-After is enforced