{
  "markdown": "# Leadpipe MCP\n\nOfficial MCP server for Leadpipe intent and data APIs.\n\nUse this server to give agents direct access to:\n- topic discovery\n- website topic analysis\n- audience preview and ad hoc query\n- saved audience management\n- audience status, results, runs, stats, and exports\n- visitor data lookup\n- tracking pixel management\n- account health and credit status\n\n## What This Is\n\nLeadpipe MCP wraps the public Leadpipe intent and data APIs in a local MCP server that agents can use over stdio.\n\nThis server is API-key authenticated by default so the full audience workflow, visitor data access, and pixel management workflows are available to agents.\n\n## Use With Claude, Cursor, and Codex\n\nMost users do not need to clone this repo or build from source. The published package is:\n\n```bash\nnpx -y @leadpipe/mcp\n```\n\nYou will need:\n\n```bash\nexport LEADPIPE_API_KEY=sk_...\n```\n\nOptional advanced override:\n\n```bash\nexport LEADPIPE_BASE_URL=https://api.aws53.cloud\n```\n\n`LEADPIPE_BASE_URL` only needs to change if you are pointing at a non-default environment.\n\n### Claude Desktop\n\nAdd this to your Claude Desktop MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"leadpipe\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@leadpipe/mcp\"],\n      \"env\": {\n        \"LEADPIPE_API_KEY\": \"sk_...\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd this to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"leadpipe\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@leadpipe/mcp\"],\n      \"env\": {\n        \"LEADPIPE_API_KEY\": \"sk_...\"\n      }\n    }\n  }\n}\n```\n\n### Codex\n\nAdd the server with the Codex CLI:\n\n```bash\ncodex mcp add leadpipe --env LEADPIPE_API_KEY=sk_... -- npx -y @leadpipe/mcp\n```\n\nThen confirm it is configured:\n\n```bash\ncodex mcp list\n```\n\n## Quick Start\n\nIf you just want to verify the package runs:\n\n```bash\nnpx -y @leadpipe/mcp\n```\n\n## Run From Source\n\nFor local development or repo hacking:\n\n```bash\nnpm install\nnpm run build\nnode dist/index.js\n```\n\nFor iterative local development:\n\n```bash\nnpm run dev\n```\n\nLocal source build MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"leadpipe\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp/dist/index.js\"],\n      \"env\": {\n        \"LEADPIPE_API_KEY\": \"sk_...\"\n      }\n    }\n  }\n}\n```\n\n## Tool Surface\n\n### Topic Discovery\n- `list_topics`\n- `get_topic_facets`\n- `search_topics`\n- `get_topic_trend`\n- `compare_topics`\n- `get_topic_movers`\n- `analyze_website_topics`\n\n### Audience Builder\n- `get_audience_filters`\n- `preview_audience`\n- `query_audience`\n- `list_audiences`\n- `get_audience`\n- `create_audience`\n- `update_audience`\n- `delete_audience`\n\n### Audience Results\n- `get_audience_status`\n- `get_audience_results`\n- `list_audience_runs`\n- `get_audience_stats`\n- `export_audience`\n\n### Visitor Data\n- `query_visitor_data`\n\n### Pixels\n- `list_pixels`\n- `create_pixel`\n- `update_pixel`\n\n### Account\n- `get_account_status`\n\n## Prompts\n\n- `discover-audience-topics`\n- `operate-saved-audience`\n- `investigate-visitor-data`\n\n## Prompt Examples\n\nSee [examples/prompt-examples.md](./examples/prompt-examples.md) for copy-paste prompts that work well with this MCP server.\n\nGood starting prompts:\n\n- \"Find 5-10 B2B topics for cloud cost optimization software, compare their recent trends, and preview an audience.\"\n- \"Create a saved audience for these topics, activate it, wait until it is ready, and then summarize the first page of results.\"\n- \"Check the status of audience `<audience-id>`. If it is ready, export it and give me the download URL.\"\n- \"Investigate visitor activity for `example.com` over the last 30 days and tell me whether our tracking setup looks healthy.\"\n- \"List our pixels, find any paused ones, and explain what needs attention.\"\n\n## Agent Playbooks\n\nFor more structured operational flows, see:\n\n- [Audience Research Playbook](./examples/playbooks/audience-research.md)\n- [Visitor Diagnostics Playbook](./examples/playbooks/visitor-diagnostics.md)\n\n## Resources\n\n- `leadpipe://docs/auth`\n- `leadpipe://docs/workflows`\n- `leadpipe://docs/data-api`\n\n## Typical Agent Workflow\n\n1. Search or analyze topics\n2. Preview audience size\n3. Create or update a saved audience\n4. Check status until the audience is ready\n5. Fetch results or export CSV\n\n## Typical Data Workflow\n\n1. Check `get_account_status`\n2. Query visitor activity with `query_visitor_data`\n3. Inspect or create pixels with `list_pixels` / `create_pixel`\n4. Pause or reactivate tracking with `update_pixel`\n\n## Development\n\n```bash\nnpm run typecheck\nnpm run build\n```\n\n## License\n\nMIT\n",
  "bytes": 4528,
  "sha": "19e796089ed35b0c9c3d9ac44a291bcedcffac75fe36d879c72790d5ab49c3e5",
  "repo_slug": "leadpipe-com/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_leadpipe_com_leadpipe_63627b47/readme"
}