# 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, and enrich contact details.

## 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 (6 credits) and phone numbers (15 credits) for any scored prospect.

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

**Account contacts** — Find other contacts at the same company as a prospect (2 credits per page).

## Credits

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

| Operation | Cost |
|-----------|------|
| Find prospects (`run_campaign`) | 13 credits per prospect |
| Enrich email | 6 credits |
| Enrich phone | 15 credits |
| Generate research report | 8 credits |
| Search account contacts | 2 credits per page |

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