API ReferenceGuide
Docs/Getting started/Install & MCP setup
Getting started · Setup

Connect Saleshub to your agent

Saleshub runs a hosted MCP server at https://app.saleshub.ai/mcp. Point your agent at it with your sh_live_ key as a bearer token — no Python, no pip, no checkout. It's multi-tenant, so each person's own key meters their own usage. One command per machine and your agent has a data department.

⚡

One command, anywhere: MCP config is per-machine, so each user runs the install once on each computer (or per agent) — then they're set from anywhere. Nobody needs the source, a PYTHONPATH, or a local server. Prefer to self-host instead? Run the local server →

0

Get your key (once)

One call returns a free-tier sh_live_ key — no card, 200 records/mo to start. Already signed in? Reveal it in your dashboard.

terminal
curl -X POST https://app.saleshub.ai/v1/signup -H 'content-type: application/json' \
  -d '{"email":"you@company.com"}'        # → sh_live_…
1

Add the hosted MCP server (with your key)

Pick your agent. Paste your sh_live_ key in place of sh_live_….

One command — connects to the hosted server. -s user makes it available in every project on this machine (drop it for just the current project).

terminal
claude mcp add -s user --transport http saleshub https://app.saleshub.ai/mcp \
  --header "Authorization: Bearer sh_live_…"
2

Restart the agent, then verify

Restart your agent so it picks up the new server, then confirm the tools are wired up:

ask your agent
What SalesHub tools do you have?

It should list seven tools:

search_prospectssearch_companiesget_companyenrich_contactenrich_companyget_emailget_phone

Then put it to work in plain language:

try it
find founders in SaaS in NYC
how the key flows

The key never touches the chat or the model. Your agent sends it as a request header straight to the hosted endpoint, which meters the call against your account:

1 · config headerAuthorization: Bearer sh_live_…
→
2 · hosted MCPapp.saleshub.ai/mcp
→
3 · your accountusage metered to your key, rate-limited by tier
prefer to self-host?

The MCP server is also an open Python package you can run locally — handy for air-gapped setups or when you want the server process on your own machine. Install it, then point your agent at the local process instead of the hosted URL. It calls the same REST API at app.saleshub.ai.

terminal
pip install saleshub-mcp

Launches the local Python server with your key as an env var.

terminal
claude mcp add saleshub \
  --env SALESHUB_API_KEY=sh_live_… \
  --env SALESHUB_BASE_URL=https://app.saleshub.ai \
  -- python -m saleshub_mcp.server
Reference
Browse the API →
Every tool is also a REST endpoint — full request and response schemas.
Skills
Pre-built workflows →
Drop a ready-made Claude Skill in instead of writing the prompt yourself.
← prevOverview