Kamata developer docs
Verify emails and phone numbers, find verified work emails, phones and LinkedIn profiles, enrich people and companies, search companies, news and competitors, and run your leads and agents: from an AI assistant (MCP) or over HTTPS (REST).
Quickstart · Reference · OpenAPI and llms.txt · Credits · Plans
| REST API | https://api.kamata.ai/v1 · reference |
|---|---|
| MCP server | https://api.kamata.ai/v1/mcp · tools and install |
| Auth | Authorization: Bearer sk_live_… (an API key), or sign in from your MCP client (OAuth, no key to copy) |
| OpenAPI | https://api.kamata.ai/openapi.json (OpenAPI 3.1, 562 operations) |
Quickstart
1. Get an API key
A workspace admin creates one in the app: https://app.kamata.ai/settings → API keys, on every plan. Pick its scopes (the reference names the scope each endpoint needs). The key is shown once; keep it server-side, for example as KAMATA_API_KEY. No account? An MCP plan gives you a key without signing up.
2. Make your first call
curl -s https://api.kamata.ai/v1/verify/email \
-H "Authorization: Bearer $KAMATA_API_KEY" \
-H "content-type: application/json" \
-d '{"email":"jane.doe@acme.example"}'
Addresses on *.example run in sample mode: free, never counted, and marked is_sample: true. Use a real address for a real answer.
3. Connect your AI assistant
- Claude (claude.ai, Desktop, mobile): Settings → Connectors → Add custom connector, URL
https://api.kamata.ai/v1/mcp, then Connect and sign in. Details - Claude Code:
claude mcp add --transport http kamata https://api.kamata.ai/v1/mcp, then/mcp→ kamata → Authenticate. - Cursor: add
{"mcpServers":{"kamata":{"url":"https://api.kamata.ai/v1/mcp"}}}to~/.cursor/mcp.json, then sign in under Settings → MCP. - ChatGPT: where your plan allows custom connectors, Settings → Apps & Connectors → add
https://api.kamata.ai/v1/mcpwith OAuth. - VS Code, Windsurf and any other client: install steps.
Reference
- Emails 4
- Phones 12
- People and companies enrichment 5
- Batches and files 8
- Lookups 2
- Credits and plan 12
- Web search, news and competitors 11
- Technologies 5
- Jobs 3
- People and companies search 50
- Signals 95
- Leads 88
- Lists 21
- Agents 124
- Inbox and sending 51
- Visitors 23
- Webhooks 9
- Workspace 37
- MCP 1
- Other 1
- Authentication and scopes · Batches and pagination · Webhooks · Rate limits · Errors
- MCP tools: every tool with its inputs and what it costs.
OpenAPI and llms.txt
- openapi.json: OpenAPI 3.1 of every endpoint above, generated from the server's own routes (also at
/openapi.json). Import it into Postman, Insomnia or a client generator. - llms.txt: a short plain-text guide for AI agents.
- llms-full.txt: everything on these pages in one plain-text file.
Credits
Paid lookups use your monthly credits. The price of each action:
| Action | Credits | Charged |
|---|---|---|
| Verify an email | 1 | per check |
| Find a work email | 1 | only when a verified email is found |
| Find a phone number | 12 | only when a phone is found |
| Match an email to a LinkedIn profile | 20 | only when a profile is found |
| Check a phone number (mobile, landline or VoIP) | 1 | per check (a number checked in the last 90 days is free) |
| Enrich a company (industry, headcount, revenue, funding, location) | 2 | only when a new company detail is found |
| List a company using a technology | 1 | per company returned (a page with no companies is free) |
| List a job post | 1 | per job post returned (a page with none is free) |
| A company's hiring or job-post technologies | 1 | per company with data returned (none on record is free) |
| Watched-company signal delivered | 5 | per signal credit a delivered signal uses (none while monitors find nothing) |
| Check where a past champion works now | 5 | per check (each champion at most once a month) |
| Look up a phone number (valid, mobile / landline / VoIP, carrier, ported) | 1 | per number looked up (the same number again within 90 days is free) |
| Look up a phone number with its listed caller name | 2 | per number looked up, name or not (the same number again within 90 days is free) |
| Look up a phone number with its name and business / person | 6 | per number looked up, name or not (the same number again within 90 days is free) |
| Look up who a phone number belongs to (caller identity) | 12 | per number looked up, match or not (the same number again within 90 days is free) |
Live numbers for your workspace: GET /v1/credits or the credits tool.
Plans
The MCP server, REST API keys and the data tools are on every plan. Leads, agents, sending, signals and visitors are on the outbound plans, where signal alerts go to Slack, email and signed webhooks on every plan. Plans and prices: https://www.kamata.ai/pricing/ · MCP plans: https://www.kamata.ai/mcp/.