Skip to main content

​
1. Get an API key

API keys are issued manually during the developer-preview period. Email hello@getbeta.io with:
  • What you’re building
  • An estimate of monthly call volume
Reply turnaround: within one business day. Self-serve signup is on the Roadmap.

​
2. Install the MCP server (optional)

For Claude Desktop or any MCP-compatible client: 
npx -y @getbeta/mcp
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS): 
{
  "mcpServers": {
    "beta": {
      "command": "npx",
      "args": ["-y", "@getbeta/mcp"],
      "env": {
        "BETA_API_KEY": "your_key_here"
      }
    }
  }
}
Restart Claude Desktop. The BETA tools (validate, enrich, timeline, corroborate, people) appear in the tool list.

​
3. Make your first call

The API base is https://api.getbeta.io. All endpoints accept POST with JSON bodies and require Bearer auth. 
curl -X POST https://api.getbeta.io/api/v1/enrich \
  -H "Authorization: Bearer $BETA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company": "Anthropic"}'
Expected response (truncated): 
{
  "verified": true,
  "confidence": 0.95,
  "entity": {
    "key": "anthropic",
    "name": "Anthropic",
    "type": "private_company",
    "publicUrl": "https://getbeta.io/company/anthropic"
  },
  "context": "Anthropic is executing an aggressive enterprise...",
  "meta": {
    "sources": ["entity_resolution", "entity_summaries"],
    "resolution": { "source": "curated", "confidence": 0.95 }
  }
}

​
Next

  • Endpoint reference — full request/response schemas for all 5 endpoints
  • Citation Contract — how BETA documents its sources, and what BETA refuses to assert
  • Recipes — multi-endpoint integration patterns for common agent flows