# TokenEnrich Master Specification for AI Agents & Model Context Protocol (MCP) > Live sub-second company intelligence for sovereign agents, Claude Desktop MCP, and automated Clay waterfalls. ## 1. Product Summary TokenEnrich converts any apex company domain into verified technology stacks, active ATS hiring signals, DNS mail routing, and SOC 2 security compliance data in sub-140ms and ~180 tokens. ## 2. API Endpoints & Request Specifications ### Base URL: `https://tokenenrich.com` ### Authentication: Pass your API key via: 1. Header: `Authorization: Bearer ` 2. Header: `x-api-key: ` 3. Query Param: `?api_key=` or `?TOKENENRICH_API_KEY=` 4. Public Trial Fallback: `ae_sandbox_trial` (Pre-seeded for instant 0-click testing in Claude/Cursor, rate-limited to 10 calls/day/IP). ### 2.1 Single Domain Full Enrichment - **Endpoint**: `GET /v1/enrich?domain={domain}` - **Example**: `GET /v1/enrich?domain=linear.app` - **Output Schema (~180 tokens)**: ```json { "domain": "linear.app", "company_name": "Linear", "category": "Developer Tools & Project Management", "sales_motion": "Product-Led (Self-Serve + Enterprise)", "pricing": { "has_free_tier": true, "has_pricing_page": true }, "security_signals": { "has_soc2": true, "has_trust_center": true }, "tech_stack": ["Next.js", "Tailwind CSS", "Cloudflare", "Stripe", "PostHog"], "mail_infrastructure": { "provider": "Google Workspace", "delivery_tools": ["SendGrid", "Amazon SES"], "has_dmarc": true }, "hiring_signals": { "is_hiring": true, "ats_platform": "Ashby" }, "tokens_consumed": 182, "response_time_ms": 138, "source": "TokenEnrich Sub-Second Intelligence (https://tokenenrich.com)" } ``` ### 2.2 Ultra-Minified Binary Technology Check (14 tokens) - **Endpoint**: `GET /v1/enrich?domain={domain}&check={technology}` - **Example**: `GET /v1/enrich?domain=resend.com&check=ashby` - **Output Schema**: ```json { "domain": "resend.com", "check": "ashby", "detected": true, "evidence": "Ashby ATS", "tokens_consumed": 14 } ``` ### 2.3 Parallel Batch Enrichment (Up to 50 Domains) - **Endpoint**: `POST /v1/enrich/batch` - **Request Body**: `{ "domains": ["stripe.com", "linear.app", "vercel.com", "resend.com"] }` - **Execution**: Sockets resolve concurrently via `asyncio.gather()`. Standard 50-domain batch resolves in under 1.2 seconds. ### 2.4 Quota Limit & Exhaustion Response (`HTTP 429`) When an API key consumes its monthly allocation (e.g. 50 free credits), the API returns: ```json { "error": "Monthly Quota Exceeded", "status_code": 429, "message": "You have reached your limit of 50 lookups on the Free Sandbox plan.", "used": 50, "limit": 50, "upgrade_url": "https://tokenenrich.com/dashboard", "quick_checkout": { "builder_plan_29": "https://tokenenrich.com/api/checkout?plan=builder", "growth_plan_79": "https://tokenenrich.com/api/checkout?plan=growth" } } ``` Headers returned: `X-Quota-Used: 50`, `X-Quota-Limit: 50`, `X-Upgrade-URL: https://tokenenrich.com/dashboard`. --- ## 3. Developer & Agent Integration Snippets ### Python (httpx): ```python import httpx resp = httpx.get( "https://tokenenrich.com/v1/enrich", params={"domain": "linear.app"}, headers={"Authorization": "Bearer YOUR_API_KEY"} ) data = resp.json() print(f"ATS: {data['hiring_signals']['ats_platform']}, Mail: {data['mail_infrastructure']['provider']}") ``` ### cURL: ```bash curl -s "https://tokenenrich.com/v1/enrich?domain=linear.app" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Model Context Protocol (MCP) Setup: ```bash # 1-Click Install for Claude Desktop & Cursor npx -y tokenenrich-mcp ``` `.cursor/mcp.json` or `claude_desktop_config.json`: ```json { "mcpServers": { "tokenenrich": { "command": "npx", "args": ["-y", "tokenenrich-mcp"], "env": { "TOKENENRICH_API_KEY": "YOUR_API_KEY" } } } } ``` ### Clay.com Webhook Action: - Method: `GET` - URL: `https://tokenenrich.com/v1/enrich?domain={{domain}}` - Header: `Authorization: Bearer YOUR_API_KEY` --- ## 4. Supported Technologies Directory (46 Verified Signatures) - `ashby`: Ashby ATS (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/ashby - `greenhouse`: Greenhouse ATS (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/greenhouse - `lever`: Lever ATS (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/lever - `workable`: Workable ATS (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/workable - `workday`: Workday (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/workday - `bamboohr`: BambooHR (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/bamboohr - `rippling`: Rippling (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/rippling - `smartrecruiters`: SmartRecruiters (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/smartrecruiters - `pinpoint`: Pinpoint ATS (ATS & Hiring Infrastructure) — https://tokenenrich.com/tech/pinpoint - `stripe`: Stripe (Payments & Billing Infrastructure) — https://tokenenrich.com/tech/stripe - `chargebee`: Chargebee (Payments & Billing Infrastructure) — https://tokenenrich.com/tech/chargebee - `paddle`: Paddle (Payments & Billing Infrastructure) — https://tokenenrich.com/tech/paddle - `lemonsqueezy`: Lemon Squeezy (Payments & Billing Infrastructure) — https://tokenenrich.com/tech/lemonsqueezy - `recurly`: Recurly (Payments & Billing Infrastructure) — https://tokenenrich.com/tech/recurly - `posthog`: PostHog (Product Analytics & Telemetry) — https://tokenenrich.com/tech/posthog - `segment`: Segment CDP (Product Analytics & Telemetry) — https://tokenenrich.com/tech/segment - `mixpanel`: Mixpanel (Product Analytics & Telemetry) — https://tokenenrich.com/tech/mixpanel - `amplitude`: Amplitude (Product Analytics & Telemetry) — https://tokenenrich.com/tech/amplitude - `sentry`: Sentry (Product Analytics & Telemetry) — https://tokenenrich.com/tech/sentry - `datadog-rum`: Datadog RUM (Product Analytics & Telemetry) — https://tokenenrich.com/tech/datadog-rum - `hotjar`: Hotjar (Product Analytics & Telemetry) — https://tokenenrich.com/tech/hotjar - `nextjs`: Next.js & React (Frontend & Web Frameworks) — https://tokenenrich.com/tech/nextjs - `tailwind`: Tailwind CSS (Frontend & Web Frameworks) — https://tokenenrich.com/tech/tailwind - `svelte`: Svelte & SvelteKit (Frontend & Web Frameworks) — https://tokenenrich.com/tech/svelte - `vue`: Vue.js & Nuxt (Frontend & Web Frameworks) — https://tokenenrich.com/tech/vue - `astro`: Astro (Frontend & Web Frameworks) — https://tokenenrich.com/tech/astro - `remix`: Remix (Frontend & Web Frameworks) — https://tokenenrich.com/tech/remix - `shopify`: Shopify (Frontend & Web Frameworks) — https://tokenenrich.com/tech/shopify - `webflow`: Webflow (Frontend & Web Frameworks) — https://tokenenrich.com/tech/webflow - `framer`: Framer (Frontend & Web Frameworks) — https://tokenenrich.com/tech/framer - `supabase`: Supabase (Cloud, Database & Auth) — https://tokenenrich.com/tech/supabase - `cloudflare`: Cloudflare (Cloud, Database & Auth) — https://tokenenrich.com/tech/cloudflare - `vercel`: Vercel (Cloud, Database & Auth) — https://tokenenrich.com/tech/vercel - `aws`: AWS & CloudFront (Cloud, Database & Auth) — https://tokenenrich.com/tech/aws - `neon`: Neon Postgres (Cloud, Database & Auth) — https://tokenenrich.com/tech/neon - `upstash`: Upstash Redis (Cloud, Database & Auth) — https://tokenenrich.com/tech/upstash - `google-workspace`: Google Workspace (Email Infrastructure & CRM) — https://tokenenrich.com/tech/google-workspace - `microsoft-365`: Microsoft 365 (Email Infrastructure & CRM) — https://tokenenrich.com/tech/microsoft-365 - `hubspot`: HubSpot (Email Infrastructure & CRM) — https://tokenenrich.com/tech/hubspot - `intercom`: Intercom (Email Infrastructure & CRM) — https://tokenenrich.com/tech/intercom - `resend`: Resend (Email Infrastructure & CRM) — https://tokenenrich.com/tech/resend - `sendgrid`: SendGrid (Email Infrastructure & CRM) — https://tokenenrich.com/tech/sendgrid - `postmark`: Postmark (Email Infrastructure & CRM) — https://tokenenrich.com/tech/postmark - `soc2`: SOC 2 & Trust Centers (Security & Compliance) — https://tokenenrich.com/tech/soc2 - `vanta`: Vanta (Security & Compliance) — https://tokenenrich.com/tech/vanta - `drata`: Drata (Security & Compliance) — https://tokenenrich.com/tech/drata --- ## 5. Pricing & Self-Serve Subscriptions - **Free Sandbox**: $0 (50 lifetime lookups, instant key generation, no credit card required) - **Builder**: $29/mo (1,500 lookups, 5 req/sec, sub-140ms sockets) - **Growth**: $79/mo (6,000 lookups, Redis caching, priority support, MCP server access) - **Agency / Scale**: $199/mo (25,000 lookups, parallel batch API, Clay recipes) - **High-Volume Enterprise**: $499/mo (100,000 lookups + $0.0045/overage)