# TAPAC Developers

REST API + MCP server for finding and verifying B2B contacts.

## Quickstart

1. Get a free API key at https://tapacapi.com/get-key
2. Send it as `Authorization: Bearer <key>`
3. Call `POST /v1/contacts/search`

## REST API

Full spec: https://tapacapi.com/openapi.json

| Method | Path | Description |
|--------|------|-------------|
| GET | /health | Health check |
| GET | /v1/status | Version + key state |
| POST | /v1/contacts/search | Find verified contacts |
| POST | /v1/contacts/verify | Verify emails via SMTP |
| GET | /v1/contacts/{id} | Fetch one contact |
| GET | /metrics | Per-endpoint access counts |
| POST | /ask | NLWeb natural-language endpoint |

Example:

```bash
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"],"location":"US","limit":20}'
```

## MCP server

- Stdio: `uvx --from git+https://github.com/axelfreeman/tapac-mcp tapac-mcp`
- Hosted streamable HTTP: https://tapacapi.com/mcp
- Server card: https://tapacapi.com/.well-known/mcp/server-card.json

## Sandbox

Add `X-Sandbox: true` to any API call to test without production data.

## SDKs

- npm: `@tapac/sdk`
- PyPI: `tapac-sdk`