# Callerapi — how to use (mcp.ai)

Connect your Callerapi account and use 7 tools for phone and SMS straight from your AI agent. Connect with your own API key. CallerAPI provides a white-label caller identification API that enhances customer trust, stops spam, fraud, and robocalls by offering branded caller ID solutions.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_callerapi?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `callerapi_dispatch_reports_manually`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/callerapi`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/callerapi/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/callerapi/dispatch/reports/manually` — Tool to manually trigger today's spam reports webhook delivery for enterprise clients. Use when an immediate webhook dispatch of spam complaint reports is needed. This endpoint is restricted to enterp
- `POST https://api.mcp.ai/api/callerapi/get/phone/number/information` — Tool to retrieve detailed information about a specific phone number, including reputation, business and carrier details, and FTC complaints. Use when the number is in E.164 format and set hlr=true to 
  - body: { hlr?: boolean, phone: string }
- `POST https://api.mcp.ai/api/callerapi/get/user/information` — Tool to retrieve information about the authenticated user, including email and credit usage details. Use after authentication to fetch current credits spent, monthly allocation, and credits left.
- `POST https://api.mcp.ai/api/callerapi/list/webhook/subscriptions` — Tool to list all webhook subscriptions for daily spam reports. Enterprise clients only. Use to retrieve all configured webhook endpoints that receive spam complaint notifications.
- `POST https://api.mcp.ai/api/callerapi/subscribe/daily/reports` — Tool to subscribe to daily spam report webhooks for enterprise clients. Instead of polling, receive webhook deliveries with spam complaint data daily. Use when you want to set up automated daily repor
  - body: { url: string }
- `POST https://api.mcp.ai/api/callerapi/test/webhook` — Tool to send a sample webhook payload to test your webhook endpoint integration. Use to validate webhook signature verification and endpoint configuration. Enterprise clients only.
  - body: { url: string }
- `POST https://api.mcp.ai/api/callerapi/unsubscribe/daily/reports` — Tool to unsubscribe from daily spam report webhooks. Use when you need to stop receiving daily reports at a specific webhook URL. Enterprise clients only.
  - body: { url: string }

## Example prompts
- "What can I do in Callerapi?"
- "Show me a summary of my Callerapi account"

## More
- Page: https://mcp.ai/callerapi
- Agent spec (llms.txt): https://mcp.ai/callerapi/llms.txt
- Postman collection: https://mcp.ai/callerapi/postman.json