Skrapp MCP

Skrapp MCP is the hosted Model Context Protocol server for Skrapp. It lets Claude, ChatGPT, Perplexity, Grok, Mistral, Microsoft Copilot, Codex, Cursor, VS Code and any other MCP client find and verify professional emails, look up phone numbers, search and enrich companies, and manage Skrapp lists, in plain language.

This repository is the public home of the service: documentation, registry manifest, examples, changelog and support. It does not contain the service source code.

Server

Full guide: https://skrapp.io/mcp. Tool reference: https://skrapp.io/api#mcp. The same content as Markdown: https://skrapp.io/mcp.md.

Related MCP server: Signaliz MCP

Quick start

You need a Skrapp account (any plan, including the free one) with an active Skrapp API key: OAuth sign-in only works for accounts that have one. Create or view your key at https://app.skrapp.io/integrations.

Chat assistants

Add Skrapp as a custom connector, paste https://mcp.skrapp.io/ as the server URL, keep OAuth as the authentication and sign in with your Skrapp account. No API key is pasted into the assistant. Custom connectors require a paid plan on Claude, ChatGPT (Plus, Pro, Business, Enterprise) and Perplexity (Pro, Max, Enterprise).

Code tools

Cursor, VS Code and Codex sign you in when they first load the server.

Authentication

Authentication is required on every request, initialize included; there is no anonymous mode. The registry manifest declares this under _meta in server.json.

OAuth 2.1 (default). Give the client only the server URL. It discovers the authorization server from /.well-known/oauth-protected-resource, registers itself (dynamic client registration, public client), and opens the Skrapp consent page; you approve once. It then holds a one-hour access token and a rotating refresh token (valid 90 days) bound to your account, using Authorization Code with PKCE (S256). Revoke access at any time from your Skrapp account or at /oauth/revoke.

API key. For scripts, CI and in-house agents that cannot open a browser. Send the same key as the REST API in X-Access-Key; X-Api-Key and Authorization: Bearer are also accepted. Every request needs a credential, including initialize: an anonymous request gets 401 with a WWW-Authenticate header that points at the protected resource metadata.

Keep keys in the environment, never in committed files:

export SKRAPP_API_KEY="<your-skrapp-api-key>"

Ready-made API key configs live in examples/apikey/, and a request example in examples/curl.sh.

Tools

Costs are Skrapp credits and match the REST API. They can change: call get_account or read the skrapp://pricing/tool-costs resource for live pricing.

Enrichment categories and cost: firmographics 1, headcount 3, financials 3, hiring 3, funding 2, technographics 2, acquisitions 2, competitors 1, social 1, traffic 1, contacts 1, signals 5.

Prompts and resources

Prompts are ready-made workflows picked from the client menu: find_decision_makers, enrich_and_save_list and verify_email_list.

Resources are read-only documents a client can load into context: skrapp://account/credits, skrapp://pricing/tool-costs, skrapp://reference/enrichment-categories and skrapp://reference/search-filters.

Claude, Claude Code, Cursor and VS Code show prompts and resources; ChatGPT uses tools only.

Safety model and limits

• Quote before spend. Company enrichment, phone lookups, list saves that trigger finder lookups and every delete first return status: "confirmation_required" with the exact cost and a confirmationToken. They run only when called again with confirm: true and that token. Nothing is charged for a quote. Single email finds and verifications (1 credit each) run directly.

• Refusals are never charged. Insufficient credits, rate limits, an expired trial or an unknown record come back as structured errors (insufficient_credits, rate_limited with retry_after_seconds, trial_expired, not_found) that say the call was not charged. Credit and rate-limit refusals also carry upgrade_url, a link to the Skrapp pricing page.

• Rate limits, per account. 250 read calls per minute, 250 spend calls per minute (separate counter), 25 bulk calls per minute.

• You stay in control. Disconnect the connector in your assistant, or revoke access from your Skrapp account. Access tokens expire within an hour.

Versioning

The server version is returned in the initialize response and shown on https://skrapp.io/mcp. Changes are recorded in CHANGELOG.md, which follows Keep a Changelog and Semantic Versioning. server.json is the MCP Registry manifest and carries the same version.

Support

• Help center: https://support.skrapp.io/hc/en-us

• Email: support@skrapp.io

• Bugs in the docs or examples: open an issue

• Security: see SECURITY.md

See also SUPPORT.md.

Privacy and terms

• Privacy policy: https://skrapp.io/privacy

• Terms of service: https://skrapp.io/terms

License

The documentation, examples and manifest in this repository are released under the MIT License. The hosted Skrapp MCP service, the Skrapp name and logo, and the Skrapp data are proprietary and governed by the terms of service.