AgentDB

Real-time curated knowledge API for AI agents.

AgentDB is a knowledge base updated Mon/Wed/Fri with summaries from 31 curated sources spanning AI/tech, startups, alternative markets, and emerging markets (Africa & Asia). Connect it to your AI agent so it always has fresh context — without you having to manage scraping, summarisation, or storage.

Quick start

1. Get an API key

curl -s -X POST https://agentdb-production-9ba0.up.railway.app/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Agent"}'

Response:

{
  "api_key": "adb_xxxxxxxxxxxxxxxxxxxx",
  "tier": "trial",
  "trial_expires_at": "2026-04-21T07:00:00",
  "message": "Welcome to AgentDB. Your 3-day trial has started."
}

Store your key — it's shown once.

2. Fetch the latest knowledge

curl https://agentdb-production-9ba0.up.railway.app/v1/knowledge/latest \
  -H "X-API-Key: adb_xxxxxxxxxxxxxxxxxxxx"

MCP server (recommended for Claude)

The AgentDB MCP server exposes two tools directly inside Claude Code or Claude Desktop: get_latest_knowledge and search_knowledge.

Install with uv (recommended)

uv handles Python version management automatically — no need to install Python 3.10+ manually.

curl -LsSf https://astral.sh/uv/install.sh | sh

Claude Code — global config

Add to ~/.claude.json (works in every Claude Code session):

{
  "mcpServers": {
    "agentdb": {
      "type": "stdio",
      "command": "/path/to/uv",
      "args": ["run", "/path/to/agentdb/mcp/server.py"],
      "env": {
        "AGENTDB_API_KEY": "adb_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Find your uv path with which uv. Find the server path with realpath mcp/server.py from this repo.

Claude Code — project config

Add a .mcp.json to your project root:

{
  "mcpServers": {
    "agentdb": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "/absolute/path/to/agentdb/mcp/server.py"],
      "env": {
        "AGENTDB_API_KEY": "adb_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agentdb": {
      "command": "uv",
      "args": ["run", "/absolute/path/to/agentdb/mcp/server.py"],
      "env": {
        "AGENTDB_API_KEY": "adb_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Run the MCP server manually (test it)

AGENTDB_API_KEY=adb_xxxxxxxxxxxxxxxxxxxx uv run mcp/server.py

Available MCP tools

REST API reference

Base URL: https://agentdb-production-9ba0.up.railway.app

All endpoints (except /health, /v1/auth/register, and /v1/knowledge/sources) require:

X-API-Key: adb_xxxxxxxxxxxxxxxxxxxx

Knowledge

Query parameters — /latest

Example response item

{
  "id": "3e7c224c-...",
  "title": "Quantum Jamming and the Search for Principles Deeper Than Quantum Mechanics",
  "content_type": "article",
  "summary": "Researchers are exploring whether cryptographic protocols...",
  "body": {
    "category": "science_research",
    "key_points": ["...", "..."],
    "source_name": "Quanta Magazine"
  },
  "tags": ["quantum-mechanics", "cryptography", "causality"],
  "confidence": 0.92,
  "relevance_score": 0.92,
  "published_at": "2026-04-18T11:40:55+00:00"
}

Auth

Sources

AgentDB ingests from 31 sources, updated Mon/Wed/Fri at 07:00 UTC.

Focus: AI/tech, startups/IPO, alternative markets, and emerging markets (Africa & Asia). No legacy wire services.

Podcasts (8)

Blogs (22)

YouTube RSS (1)

Full machine-readable list: GET /v1/knowledge/sources

Pricing

Upgrade via /v1/payments/checkout (Stripe or crypto).

Self-hosting

git clone https://github.com/AgentBC9000/agentdb
cd agentdb
cp .env.example .env   # fill in ANTHROPIC_API_KEY, DATABASE_URL, ADMIN_SECRET
docker-compose up

The scraper runs independently — trigger it manually or set a cron:

cd scraper
ANTHROPIC_API_KEY=... AGENTDB_API_URL=... ADMIN_SECRET=... python run.py