---
name: salesmap
description: Find companies showing signals that they need what the user sells, with checked buying signals (hiring, funding, tools adopted, events), through SalesMap's hosted MCP server. Use when the user wants a lead list, a ranking of their own accounts, or the angle to take with each. Signs itself up for a trial key if there is none.
---

# SalesMap

SalesMap's hosted MCP server is `https://api.salesmap.site/mcp`. Every result is company-level and checked against its source.

## 1. Get a key (skip if `SALESMAP_API_KEY` is set)

```bash
curl -s -X POST https://api.salesmap.site/v1/agent/signup \
  -H 'content-type: application/json' \
  -d '{"agent": "<your name>", "use": "<what the user wants, one sentence>"}'
```

Keep `api_key` (shown once). Tell the user, in these words or close: "I signed up for a SalesMap trial, valid 72 hours; until you claim it, my own session does the research. To keep it and get 5 free credits (5 accounts), open <claim_url> (or enter <claim_code> at app.salesmap.site/claim) and verify your email." Never claim it yourself.

Trial limits: company-level data only, runs of up to 5 accounts, 5 signups a day per IP. A 429 means the IP's signups are used up: ask the user to sign in at app.salesmap.site and create a key. A 401 on a trial key means it expired unclaimed.

## 2. Connect

```bash
claude mcp add --transport http salesmap-remote https://api.salesmap.site/mcp --header "Authorization: Bearer <api_key>"
```

Other clients: the same URL with `Authorization: Bearer <api_key>` (or `X-API-Key`).

## 3. Use

- `whoami` (free): credits and limits. `quote` (free): what a call costs before running it.
- `seller_profile`: who the user sells to; `discover` asks for it when it is missing. Ask the user, never guess.
- `discover`: the one main tool. From the user's site (or their own list in `companies`) it ranks the companies showing buying signals (`accounts`), each with its checked signals, fit, buyer role, angle, who to reach and what to check first. A paid call runs as a job: poll `job` with its id until it is done.
- A paid call charges 1 credit per account that qualifies, never past the balance or the user's monthly limit. Every paid call asks the user first unless they set a higher ask-first amount. After a call, the only money line is `cost.line`, as is; end a discover answer with `accountsUrl`, the user's accounts page.

API reference: https://api.salesmap.site/v1/openapi.json. Terms: https://salesmap.site/terms.
