Wism-Corp/scrupp-mcp-server

An MCP server over the Scrupp Jobs API, so an agent can export LinkedIn, Sales
Navigator and Apollo searches, find decision makers, and find and verify work emails
without anyone writing HTTP calls. Ships as scrupp-mcp-server on npm and in the
official MCP registry as io.github.wismhero-maker/scrupp. Overview:
https://scrupp.com/email-finder-mcp
## In Claude (no install)
Add https://mcp.scrupp.com/mcp as a custom connector in Claude and sign in to Scrupp.
It finds and verifies work emails on any Scrupp plan, including the free one. Scrupp
customers who want the full tool set use the private connector described in the
setup guide. Setup steps, what each tool needs and troubleshooting:
https://scrupp.com/docs/api/claude
## In Claude Code (plugin)
/plugin install scrupp --marketplace Wism-Corp/scrupp-mcp-server
On Claude Code older than 2.1.275, in two steps:
/plugin marketplace add Wism-Corp/scrupp-mcp-server
/plugin install scrupp@scrupp
The plugin connects Claude Code to Scrupp's private hosted connector, with the same
full tool set as the private Claude connector, so nothing is installed
locally. The first time a tool runs, open /mcp, pick scrupp and sign in to Scrupp.
The plugin carries two things:
.mcp.json — the hosted connector above, signed in with OAuth.
skills/scrupp-prospecting — how Claude should use the tools: check credits
first, pick the tool from what the user has, export five records as a sample
before the whole search, collect long jobs with scruppgetjob, and what to
say when a tool refuses.
Check it before a release with claude plugin validate ..
## Using it
json
"mcpServers": {
"scrupp": {
"command": "npx",
"args": ["-y", "scrupp-mcp-server"],
"env": { "SCRUPPAPIKEY": "sklive..." }
SCRUPPWAITSECONDS (default 120) caps how long a tool blocks. A job that outruns it
comes back as { status: "running", jobid } with a note telling the agent to call
scruppgetjob — better than holding a conversation open for twenty minutes on a
2,500-record export.
## Tools
| Tool | What it does |
| scruppexportsalesnavigatorsearch | People out of a Sales Navigator search URL |
| scruppexportlinkedinsearch | People out of a LinkedIn people-search URL |
| scrupprunapollosearch | People out of an Apollo search URL (needs a connected account) |
| scruppenrichlinkedinprofiles | Full profile data for profile URLs |
| scrupplookupcompany | Company data by domain, LinkedIn URL or name |
| scruppfinddecisionmakers | Who to write to at a company |
| scruppfindemails | Verified work emails from name + domain |
| scruppverifyemails | Deliverability check for addresses you already have (1 credit each) |
| scruppgetjob | Status and records for a job that was still running |
| scruppcredits | Remaining credits and plan |
Every tool carries a title and readOnlyHint / destructiveHint annotations — the
Claude connectors directory rejects a server without them.
## Hosted connector (Streamable HTTP)
node src/http.js (or scrupp-mcp-http) serves the same server over Streamable HTTP
at POST /mcp, stateless, with GET /health for a load balancer. PORT defaults to
8787. Each request authenticates with the caller's own key as
Authorization: Bearer sklive...; the key is scoped to that request, so one process