---
name: platformpilot-mcp
description: Connect an MCP client to PlatformPilot's hosted MCP servers (PlatformPilot Agents, Apollo.io via PlatformPilot, PlatformPilot Brain, Meta Ads via PlatformPilot) through OAuth 2.1 with PKCE and dynamic client registration. Use when a user wants PlatformPilot's company memory, its investigation and scoring agents, or the tools PlatformPilot hosts, from Claude, Cursor, ChatGPT, or another MCP client.
metadata:
  author: PlatformPilot
  homepage: https://mcp.platformpilot.ai/
---

# Connect to PlatformPilot MCP

## When to use

- Use this gateway when a user wants PlatformPilot capabilities from an MCP client such as Claude, Cursor, or ChatGPT: the company's memory, its investigation and scoring agents, or the third-party tools PlatformPilot hosts.
- Use PlatformPilot Agents when the user wants PlatformPilot to investigate an incident or signal, score or rank candidates against an explicit rubric, or run a PlatformPilot chat turn from another client.
- Use Apollo.io via PlatformPilot when the user wants to find or enrich prospects, companies, or contacts, or work Apollo.io sequences and tasks.
- Use PlatformPilot Brain when the user asks what the company knows, learned, or decided; wants to save a learning or an outcome; or asks how two entities connect or what an entity affects.
- Use Meta Ads via PlatformPilot when the user asks about Meta Ads performance or wants to inspect campaigns.

## Servers

- [PlatformPilot Agents](https://mcp.platformpilot.ai/agents/.well-known/mcp/server-card.json) (`agents`): PlatformPilot's agents as MCP tools: hypothetico-deductive investigation of events and alerts, defeasible-reasoning scoring of candidates against a rubric, and the PlatformPilot chat assistant. MCP endpoint: https://mcp.platformpilot.ai/agents/mcp. Auth: OAuth 2.1 (PKCE, dynamic client registration). Discovery: https://mcp.platformpilot.ai/agents/.well-known/oauth-protected-resource
- [Apollo.io via PlatformPilot](https://mcp.platformpilot.ai/apollo/.well-known/mcp/server-card.json) (`apollo`): Apollo.io people and company search, contact and organization enrichment, sequences, tasks, and deals, authorized through PlatformPilot. MCP endpoint: https://mcp.platformpilot.ai/apollo/mcp/. Auth: OAuth 2.1 (PKCE, dynamic client registration). Discovery: https://mcp.platformpilot.ai/apollo/.well-known/oauth-protected-resource
- [PlatformPilot Brain](https://mcp.platformpilot.ai/brain/.well-known/mcp/server-card.json) (`brain`): Organizational memory for a company: search and recall memories, save reusable learnings, report outcomes, and explain how entities (people, projects, vendors, systems) relate. MCP endpoint: https://mcp.platformpilot.ai/brain/mcp. Auth: OAuth 2.1 (PKCE, dynamic client registration). Discovery: https://mcp.platformpilot.ai/brain/.well-known/oauth-protected-resource
- [Meta Ads via PlatformPilot](https://mcp.platformpilot.ai/meta-ads/.well-known/mcp/server-card.json) (`meta-ads`): Meta Ads (Facebook and Instagram) accounts, campaigns, ad sets, ads, and insights. MCP endpoint: https://mcp.platformpilot.ai/meta-ads/http. Auth: PlatformPilot infrastructure only (gateway key).

## Steps

1. Add the server's MCP endpoint to the client as a Streamable HTTP server.
2. Let the client run OAuth: the first request returns 401 with a WWW-Authenticate header that names the protected-resource metadata; the client discovers the authorization server, registers (RFC 7591), and opens the authorization page for the user. Full walkthrough: https://mcp.platformpilot.ai/auth.md
3. After the user consents, every request carries `Authorization: Bearer <token>`. Renew with the refresh token; on 401, re-run discovery.
4. Call `tools/list` to read the tools the user's organization exposes, then call tools by name.

## Edge cases

- 403 `invalid_client`: the server is PlatformPilot infrastructure only; there is no self-service path.
- 404 "Unknown MCP server": the name is not routed; read https://mcp.platformpilot.ai/llms.txt for the current list.
- 429: per-organization rate limit; back off and retry.