Cryptopolitan Agent API

Quick Start

1

Register

Get a free API key instantly — no credit card required.

curl -X POST /api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","email":"[email protected]"}'

2

Get Your Key

You'll receive a key starting with cpk_live_ in the response.

// Response
{
  "api_key": "cpk_live_abc123...",
  "tier": "free"
}

3

Make Your First Call

Fetch the latest enriched articles with one request.

curl /api/v1/articles \
  -H "X-API-Key: cpk_live_abc123..."

Endpoints

Method	Path	Description	Auth
GET	/llms.txt	LLM & Agent access policy	Public
GET	/llms-sitemap.xml	LLM-optimised sitemap (200 latest articles)	Public
GET	/api/v1/docs	OpenAPI 3.0 specification	Public
GET	/api/v1/health	Health check with database status	Public
GET	/api/v1/categories	Available article categories	Public
POST	/api/v1/register	Register for a free API key	Public
GET	/api/v1/articles	Enriched article feed with filters	Free
GET	/api/v1/search	Keyword search over recent articles	Free
GET	/api/v1/usage	Your API key usage stats	Free
POST	/mcp	MCP server (Streamable HTTP transport)	Public
GET	/mcp/sse	MCP server (SSE transport)	Public
GET	/.well-known/mcp.json	MCP server discovery metadata	Public

MCP Server No API key required

Connect your AI coding assistant directly to Cryptopolitan via the Model Context Protocol. 5 tools — articles, search, categories, article-by-URL, and docs.

Claude Code

claude mcp add cryptopolitan-news \
  --transport sse \
  https://agent.cryptopolitan.com/mcp/sse

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cryptopolitan-news": {
      "url": "https://agent.cryptopolitan.com/mcp/sse"
    }
  }
}

Windsurf

Add to MCP config:

{
  "mcpServers": {
    "cryptopolitan-news": {
      "serverUrl": "https://agent.cryptopolitan.com/mcp/sse"
    }
  }
}

Discovery: /.well-known/mcp.json • SSE: /mcp/sse • Streamable HTTP: /mcp

Rate Limits

Free Tier

Unlimited

content access

Unlimited articles and usage endpoints. Search: 10,000 requests/day. Register instantly.