# Splattr MCP Server

The Splattr MCP server exposes Splattr's prospecting capabilities directly inside AI tools — Claude Code, Claude Desktop, Cursor, and any other client that supports the [Model Context Protocol](https://modelcontextprotocol.io).

Instead of switching between your AI tool and the Splattr app, you can run entire prospecting workflows from a single conversation: create campaigns, train them with a plain English description, find and score prospects, enrich contact details, and push to your CRM.

## What you can do

**Campaign management** — Create, configure, rename, and archive campaigns. Train a campaign by describing your product and target customer in plain text; the server derives search filters automatically.

**Prospect search** — Run a campaign to find and score prospects. Scored prospects include fit reasoning and outreach guidance specific to each person.

**Contact enrichment** — Look up verified email addresses (2 credits) and phone numbers (5 credits) for any scored prospect.

**Research reports** — Generate a detailed research report for a prospect (5 credits) covering their background, company context, and personalized outreach angles.

**CRM push** — Push prospects directly to a connected CRM (HubSpot, Salesforce).

**Account contacts** — Find other contacts at the same company as a prospect (1 credit).

## Credits

Most read operations are free. Write and enrichment operations cost credits:

| Operation | Cost |
|-----------|------|
| Find prospects (`run_campaign`) | Per prospect (varies by plan) |
| Enrich email | 2 credits |
| Enrich phone | 5 credits |
| Generate research report | 5 credits |
| Search account contacts | 1 credit |

Use `get_credits` to check your balance before running expensive operations.

## Async operations

Several tools — `run_campaign`, `enrich_email`, `enrich_phone`, `generate_report`, and `retry_enrichment` — start background jobs and return a task ID immediately. Use `get_task_status` to poll for results.

These operations can take up to a few minutes. You do not need to keep the conversation open while they run.

## Next steps

- [Quickstart](./quickstart) — connect the server to Claude Code or Claude Desktop in under 2 minutes
- [Authentication](./authentication) — how OAuth works with the Splattr MCP server
- [Tools reference](./tools/campaigns) — full documentation for every available tool