MCP Server

Connect any AI tool directly to the Blitz API documentation for hallucination-free code generation.

Agents & LLMs: a Markdown version of this page is available by appending .md to the URL, and the full documentation index is at llms.txt.

What is the Blitz API MCP Server?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect directly to external data sources instead of relying on their training data. The Blitz API MCP Server gives any compatible AI tool live access to the complete Blitz API documentation — every endpoint, parameter, response schema, and code example. When your AI assistant needs to write code that calls Blitz API, it searches the actual documentation instead of guessing. MCP Server URL

https://docs.blitz-api.ai/mcp

Why Use It?

AI models are trained on static snapshots of the internet. When they generate code for an API, they often:

Hallucinate endpoints that don’t exist
Use outdated parameter names
Return incorrect response shapes

With the Blitz API MCP Server connected:

Without MCP	With MCP
AI guesses endpoint URLs	AI reads the real API reference
Outdated parameter names	Always up-to-date parameter schemas
Incorrect response shapes	Accurate response structures from source
Back-and-forth corrections	Ship correct code on the first try

What Content is Available?

The MCP server provides a search tool that covers the entire Blitz API documentation:

Content	Description
API endpoints	Full reference for every v2 endpoint — methods, URLs, and parameters
Request schemas	Required and optional fields, types, and example payloads
Response schemas	Complete response structures with field descriptions
Waterfall logic	How cascade/waterfall search works, ICP scoring, and priority levels
Code examples	cURL commands, Node.js, Python, and integration patterns
Guides & recipes	Enrichment workflows, CRM hygiene, and integration tutorials

Setup

Claude (claude.ai)
Cursor
VS Code
Claude Desktop

Open Claude.ai and start a new conversation.
Click the ”+” or attachments button.
Select “Manage Connectors” and click on “Add custom Connector”.
Copy / Paste this URL into “Remote MCP server URL”: https://docs.blitz-api.ai/mcp.

You may need to explicitly enable the connector for each new conversation using the attachments button.

Press Cmd + Shift + P (macOS) or Ctrl + Shift + P (Windows/Linux) to open the command palette, then search for “Open MCP Settings”.In your mcp.json file, add:

{
  "mcpServers": {
    "blitz-api": {
      "url": "https://docs.blitz-api.ai/mcp"
    }
  }
}

In Cursor’s Agent chat, ask: "What tools do you have available?" — you should see the Blitz API documentation search tool listed.

Make sure the MCP server shows a green status indicator in your MCP settings after adding it.

In your project root, create a .vscode/mcp.json file (or open it if it already exists):

{
  "servers": {
    "blitz-api": {
      "type": "http",
      "url": "https://docs.blitz-api.ai/mcp"
    }
  }
}

Older versions of Claude Desktop don’t support remote MCP servers natively. Use the mcp-remote wrapper:

{
  "mcpServers": {
    "blitz-api": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://docs.blitz-api.ai/mcp"]
    }
  }
}

Save this in your Claude Desktop config file and restart the application.

Example Prompts

Once connected, try these prompts with your AI tool:

Write a Python script to find decision-makers

Using Blitz API, write a Python script to find the Head of Sales at a company given its LinkedIn URL. Include rate limiting and error handling.

Get parameters for an endpoint

What parameters does the waterfall ICP keyword search endpoint accept? Show me a complete example JSON body.

Generate a Node.js enrichment function

Generate a Node.js function that enriches a list of LinkedIn profile URLs with work emails using Blitz API. Handle the case where the email is not found.

Build a full enrichment pipeline

Write a Python script that takes a list of company domains, converts each to a LinkedIn URL, then finds the VP of Sales using the Blitz API waterfall search. Include retry logic.

Troubleshooting

The AI tool doesn't seem to use the documentation

Some AI tools require you to explicitly enable the connector for each conversation. In Claude, use the attachments button to select the Blitz API connector. In Cursor, make sure the MCP server shows a green status indicator in your MCP settings.

Connection fails after adding the config

Restart your AI tool after adding the MCP configuration. Most clients need a full restart to detect new MCP servers. Verify the URL is exactly https://docs.blitz-api.ai/mcp — no trailing slash, no extra path segments.

Claude Desktop doesn't connect

Older versions of Claude Desktop don’t support remote MCP servers natively. Use the mcp-remote wrapper shown in the Claude Desktop tab above.

Network or timeout errors

Check your network connection and try again. If the issue persists, verify the server is reachable by opening https://docs.blitz-api.ai/mcp in your browser.

Introduction

Getting Started

Core Concepts

Recipes (Use Cases)

Integrations

Appendix

MCP Server

MCP Server

What is the Blitz API MCP Server?

Why Use It?

What Content is Available?

Setup

Example Prompts

Troubleshooting

​MCP Server

​What is the Blitz API MCP Server?

​Why Use It?

​What Content is Available?

​Setup

​Example Prompts

​Troubleshooting

MCP Server

What is the Blitz API MCP Server?

Why Use It?

What Content is Available?

Setup

Example Prompts

Troubleshooting