Developers
REST API MCP Sandbox TAPAC is an MCP server and REST API for finding and verifying B2B contacts. This is the quickstart.
1 · Get a key
100 free searches, no credit card. Get a key at /get-key, then send it as a Bearer token:
Authorization: Bearer <your-api-key>
2 · REST API
Full machine-readable spec: /openapi.json (OpenAPI 3.1). Auth metadata: /.well-known/oauth-protected-resource.
| Method | Path | Description |
|---|---|---|
| GET | /health | Health check |
| GET | /v1/status | Version + API-key state |
| POST | /v1/contacts/search | Find verified contacts |
| POST | /v1/contacts/verify | Verify email addresses via SMTP |
| GET | /v1/contacts/{id} | Fetch one contact |
| GET | /metrics | Per-endpoint access counts |
| POST | /ask | NLWeb natural-language endpoint |
Example — find contacts
curl -X POST https://tapacapi.com/v1/contacts/search \
-H "Authorization: Bearer $TAPAC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"industry":"SaaS","job_titles":["VP Sales"],"company_size":"50-500 employees","location":"US","source":"website","limit":20}'
3 · MCP server
Stdio install for any MCP client:
uvx --from git+https://github.com/axelfreeman/tapac-mcp tapac-mcp
Hosted streamable-HTTP endpoint: https://tapacapi.com/mcp · Server card: /.well-known/mcp/server-card.json
4 · Sandbox
Test without touching production data — add the header X-Sandbox: true to any API call. The sandbox returns sample data and records no production side effects.
5 · SDKs
Official SDKs — npm @tapac/sdk and PyPI tapac-sdk. Source: github.com/axelfreeman/tapac-mcp.