Technical Reference

API Documentation & Agent SDKs

Sub-200ms firmographics, DNS mail infrastructure, 500+ tech stack signatures, and active ATS job detection engineered for LLM agents and Clay waterfalls.

Authentication

Bearer Token

All API requests must supply your API key in the standard Authorization header or as an x-api-key request header: 

# Provide Bearer authentication in headers
Authorization: Bearer ae_live_YOUR_API_KEY

Single Domain Resolution

GET /v1/enrich

Resolves apex domain DNS mail routing, active ATS job portals, 500+ frontend/backend tech stacks, and SOC 2 compliance badges in ~140ms.

GET https://tokenenrich.com/v1/enrich?domain=linear.app
Python (httpx) 
import httpx

async def enrich_domain(domain: str) -> dict:
    headers = {"Authorization": "Bearer ae_live_YOUR_API_KEY"}
    async with httpx.AsyncClient(timeout=5.0) as client:
        res = await client.get(f"https://tokenenrich.com/v1/enrich?domain={domain}", headers=headers)
        return res.json()
● 200 OK · 182 Tokens · 142ms 
{
  "domain": "linear.app",
  "company_name": "Linear",
  "category": "Project Management & Issue Tracking",
  "tech_stack": ["Next.js", "Tailwind CSS", "Vercel", "Segment"],
  "mail_infrastructure": {
    "provider": "Google Workspace",
    "has_spf": true,
    "has_dmarc": true
  },
  "hiring": {
    "is_hiring": true,
    "ats": "Ashby"
  },
  "security": {
    "has_soc2": true
  },
  "confidence": 0.99,
  "provenance": ["dns_mx_records", "tls_handshake", "app_subdomain_probe"],
  "tokens_consumed": 182,
  "response_time_ms": 142
}
EXTREME TOKEN SAVINGS Dynamic Field Masking & Single-Check Mode

Cut tokens from 180 down to 12 tokens when your AI agent only needs binary verification:

# Single Binary Check (12 Tokens)
GET /v1/enrich?domain=linear.app&check=stripe
# Custom Field Masking (45 Tokens)
GET /v1/enrich?domain=linear.app&fields=tech_stack,hiring_signals

Parallel Batch Enrichment

POST /v1/enrich/batch

Enrich up to 100 apex domains concurrently in parallel in under 3 seconds.

POST https://tokenenrich.com/v1/enrich/batch 
const response = await fetch("https://tokenenrich.com/v1/enrich/batch", {
  method: "POST",
  headers: {
    "Authorization": "Bearer ae_live_YOUR_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    domains: ["stripe.com", "linear.app", "vercel.com", "shopify.com"]
  })
});

const results = await response.json();

Model Context Protocol (MCP) Setup

JSON-RPC / stdio

TokenEnrich provides an open-source MCP server published on npm (tokenenrich-mcp) ↗ and GitHub ↗.

Option 1: Claude Code CLI (1-Command Install) 
claude mcp add tokenenrich -- npx -y tokenenrich-mcp
Option 2: Cursor IDE & Claude Desktop (JSON Config)
~/Library/Application Support/Claude/claude_desktop_config.json or .cursor/mcp.json 
{
  "mcpServers": {
    "tokenenrich": {
      "command": "npx",
      "args": ["-y", "tokenenrich-mcp"],
      "env": {
        "TOKENENRICH_API_KEY": "ae_live_YOUR_API_KEY"
      }
    }
  }
}

CrewAI & LangChain @tool Decorator

Agent Tool Calling

Embed firmographic verification into multi-agent qualification and outbound sales pipelines: 

from crewai.tools import tool
import requests

@tool("TokenEnrich Firmographics Tool")
def enrich_company(domain: str) -> str:
    """Retrieves verified tech stack, mail provider, hiring status and SOC2 in ~180 tokens."""
    res = requests.get(f"https://tokenenrich.com/v1/enrich?domain={domain}", 
                       headers={"Authorization": "Bearer ae_live_YOUR_KEY"})
    return res.text

Clay.com Waterfall Setup

1-Click HTTP Action

Replace 5 slow, expensive waterfall columns with a single sub-200ms API call:

  1. In your Clay table, add an "HTTP API" action column.
  2. Set Method to GET and URL to https://tokenenrich.com/v1/enrich?domain=
  3. Add Header: Authorization $\rightarrow$ Bearer ae_live_YOUR_API_KEY
  4. Map output columns directly: tech_stack, mail_infrastructure.provider, hiring.ats, and security.has_soc2.

HTTP Response Codes & Quotas

RFC 7231
200 OK

Domain resolved successfully with full verified signals.

401 Unauthorized

Missing or invalid Bearer API key in request headers.

429 Quota Exceeded

Monthly lookup quota reached. Upgrade plan in console.