# PrimeRFP Scout — Developer & MCP Documentation

> Official developer documentation for PrimeRFP SCOUT: a remote Model Context Protocol (MCP) server for government contracting intelligence. Connect Claude, ChatGPT, Cursor, Windsurf, VS Code, n8n, and custom agents to opportunity classification, federal + SLED opportunity search, USASpending awards, recompete pipeline, congressional policy signals, budget intelligence, GAO protests, teaming, and capture tools. Endpoint: https://mcp.primerfp.com/mcp (Streamable HTTP). Company overview: https://primerfp.com/llms.txt

Important notes:
- SCOUT is a hosted remote MCP server — not a local npm/pip package. Authentication uses OAuth 2.0 client credentials (API key as client_secret) or Bearer `Authorization: Bearer prfp_…`.
- MCP requires SCOUT MCP Trial, MCP Explorer, or Tactics / Strategic / Premier — the web-only Free plan does not include MCP access.
- Entry tiers (MCP Trial, MCP Explorer) follow a "Classify + Connect" model and expose a focused tool list — `classify_opportunity`, `search_opportunities`, and `get_opportunity_detail`. Daily limits: classify 25/day (Trial), 500/day (Explorer); search 10/day (Trial), 50/day (Explorer); both unlimited on Tactics and above.
- Intelligence tools (award history, recompete pipeline, teaming match, discovery reports, capture bundle, etc.) are gated to Tactics / Strategic / Premier — they are hidden from tools/list and blocked at the backend for entry tiers, so no preview stubs are returned.
- SCOUT exposes 33 tools with readOnlyHint/destructiveHint annotations for AI client directory compliance (ChatGPT Apps, Claude Connectors); the number visible in tools/list depends on your tier.
- Core intelligence runs on PrimeRFP's private AI stack; customer opportunity data is not sent to third-party LLM APIs for Scout's intelligence layer.
- For product marketing, pricing tiers, and Intel Hub public data, see https://primerfp.com/llms.txt

## MCP — Start Here

- [MCP Getting Started](https://docs.primerfp.com/mcp/getting-started/): Create an API key, connect ChatGPT/Claude/Cursor/Windsurf/VS Code/n8n in ~5 minutes; Smithery one-click install
- [Authentication](https://docs.primerfp.com/mcp/authentication/): OAuth 2.0 discovery (`/.well-known/oauth-authorization-server`), client_credentials, Bearer token, legacy header
- [Available MCP Tools](https://docs.primerfp.com/mcp/tools/): Full reference for all 33 tools — parameters, tiers, example prompts
- [Tiers & Limits](https://docs.primerfp.com/mcp/pricing/): MCP Trial vs Explorer (Classify + Connect) vs Tactics/Strategic/Premier — classify & search caps, look-back, gated intelligence tools

## MCP Server Endpoints & Listings

- MCP server URL: https://mcp.primerfp.com/mcp
- OAuth token endpoint: https://mcp.primerfp.com/oauth/token
- OAuth metadata: https://mcp.primerfp.com/.well-known/oauth-authorization-server
- Official MCP Registry: https://registry.modelcontextprotocol.io — namespace `com.primerfp.scout/scout`
- Smithery directory: https://smithery.ai/servers/primerfp/scout
- ChatGPT Apps directory: **SCOUT for Federal Contracting** — public listing in ChatGPT Settings → Apps (connect with your `prfp_` API key)
- Scout web app (API keys): https://scout.primerfp.com
- Integrations landing: https://primerfp.com/integrations
- MCP product page: https://primerfp.com/mcp

## Tool Categories (33 tools)

- **Opportunities:** opportunity classification (`classify_opportunity` → primary industry, work type, sub-categories, tags), semantic search (federal + SLED), opportunity detail, summaries, change/amendment tracking
- **Awards & recompete:** USASpending award history/summary, recompete pipeline, PIID dossier, subawards, contract vehicles
- **Budget & fiscal:** congressional budget line items and agency funding summaries
- **Policy intel:** congressional hearing testimony signals (NDAA, appropriations, procurement policy)
- **Protests:** GAO bid protest history, sustain rates, trend analytics
- **Capture & compound:** agency briefing, capture intelligence, contract landscape, pipeline forecasts, capture bundle
- **Teaming & reports:** teaming match (Premier), discovery reports, scheduled reports, report email
- **Account:** tier/limits, usage metrics, competitive positioning (`scout_vs`), search quality feedback

## Example Prompts (after connecting MCP)

- "Classify this solicitation — what primary industry, work type, and sub-categories does it map to?"
- "Find IT services opportunities under $10M posted in the last 30 days."
- "What contracts is Leidos losing to recompete this year in NAICS 541511?"
- "Give me an agency briefing for DHS including budget, awards, and recompete timing."
- "Find 8(a) teaming partners with cloud infrastructure past performance."
- "Summarize GAO protest sustain rates for DoD over the last three years."

## REST API

- [API Overview](https://docs.primerfp.com/api/overview/): Direct REST access patterns (MCP is the recommended integration path)

## Support & Legal

- MCP support: mcp-support@primerfp.com
- Documentation home: https://docs.primerfp.com/
- [Legal](https://docs.primerfp.com/legal/): terms references for integrators
- Privacy policy: https://primerfp.com/privacy-policy
- Pricing: https://primerfp.com/pricing