# SAM.gov data for AI agents SAM Gov API works with any AI agent through a remote MCP server at https://samgovapi.io/api/mcp and a REST API with an OpenAPI document. An agent gets 18 tools for SAM.gov registrations, contract opportunities, exclusions, USAspending awards, NAICS size standards and GSA labor rates, and can request its own key with your approval. Below are setup guides for 28 clients and 26 task recipes.Checked on 2026-11-13.Official source: [Model Context Protocol](https://modelcontextprotocol.io) | MCP server | https://samgovapi.io/api/mcp | | --- | --- | | Transport | Streamable HTTP, stateless JSON over POST | | Auth | Authorization: Bearer | | Tools | 18 product tools; 5 need no key (search, fetch, start_signup, finish_signup, give_feedback) | | Client guides | 28 | | Task recipes | 26 | | Free plan | 100 credits a month | ## What an agent gets ### MCP server Tools an agent picks by itself: registration status by UEI or CAGE, entity records, opportunity and award search, recompetes, exclusions, NAICS and size standards, labor rates, expiring registrations and, on paid plans, teaming partners. Every answer carries meta.as_of and a link to the SAM.gov or USAspending record.Server URL ``` https://samgovapi.io/api/mcp ``` ### REST API The same operations as JSON over HTTPS for scripts, automations and GPT Actions, described by an OpenAPI document. Same key, same credits, cursor pagination, errors that cost nothing.First call ``` curl "https://samgovapi.io/api/v1/registration-status/ZXBCU6K5KL99" \ -H "Authorization: Bearer $SAMGOVAPI_API_KEY" ``` ## Pick your client ### Coding agents and CLIs [MCP / testedClaude Codeclaude mcp add --transport http, or a shared .mcp.json](https://samgovapi.io/agents/claude-code)[MCP / testedOpenAI Codex CLIcodex mcp add with --bearer-token-env-var](https://samgovapi.io/agents/codex-cli)[MCPGemini CLIhttpUrl entry in settings.json, or gemini mcp add](https://samgovapi.io/agents/gemini-cli)[MCPGooseRemote extension (Streamable HTTP) with a custom header](https://samgovapi.io/agents/goose) ### Editors and IDEs [MCPCursormcp.json with url and ${env:...} header](https://samgovapi.io/agents/cursor)[MCPWindsurfmcp_config.json with serverUrl and headers](https://samgovapi.io/agents/windsurf)[MCPVS Code (GitHub Copilot).vscode/mcp.json, type http, password input](https://samgovapi.io/agents/vs-code)[MCPZedcontext_servers entry with url and headers](https://samgovapi.io/agents/zed)[MCPClinetype streamableHttp in cline_mcp_settings.json](https://samgovapi.io/agents/cline)[MCPContinueconfig.yaml, streamable-http, secrets header](https://samgovapi.io/agents/continue) ### Chat apps [MCP / testedClaude DesktopCustom connector with a request header](https://samgovapi.io/agents/claude-desktop)[MCPClaude.ai connectorsCustom connector, Pro to Enterprise](https://samgovapi.io/agents/claude-ai)[MCP or RESTChatGPTKeyless MCP server, or GPT Actions with a key](https://samgovapi.io/agents/chatgpt)[MCPLibreChatlibrechat.yaml, shared or per-user key](https://samgovapi.io/agents/librechat) ### Agent frameworks and SDKs [MCP / testedOpenAI Agents SDKMCPServerStreamableHttp with headers](https://samgovapi.io/agents/openai-agents-sdk)[MCPOpenAI Responses APItype mcp tool with server_url and headers](https://samgovapi.io/agents/openai-responses-api)[MCP / testedGoogle ADKMcpToolset with StreamableHTTPConnectionParams](https://samgovapi.io/agents/google-adk)[MCP / testedLangChain and LangGraphMultiServerMCPClient, transport http](https://samgovapi.io/agents/langchain)[MCP / testedLlamaIndexBasicMCPClient with headers, McpToolSpec](https://samgovapi.io/agents/llamaindex)[MCP / testedCrewAIAgent(mcps=[MCPServerHTTP(...)])](https://samgovapi.io/agents/crewai)[MCP / testedVercel AI SDKcreateMCPClient from @ai-sdk/mcp](https://samgovapi.io/agents/vercel-ai-sdk)[MCP / testedMastraMCPClient with requestInit headers](https://samgovapi.io/agents/mastra) ### Automation platforms [MCP or RESTn8nMCP Client Tool or HTTP Request node](https://samgovapi.io/agents/n8n)[MCP or RESTZapierWebhooks by Zapier or MCP Client by Zapier](https://samgovapi.io/agents/zapier)[MCP or RESTMakeHTTP module with an API key keychain](https://samgovapi.io/agents/make) ### Plain HTTP [RESTPython requestsrequests with a Bearer header](https://samgovapi.io/agents/python-requests)[RESTNode.js fetchBuilt-in fetch, no packages](https://samgovapi.io/agents/node-fetch)[MCP or REST / testedcurlREST calls and raw MCP JSON-RPC](https://samgovapi.io/agents/curl) ## Let the agent get its own key An agent can request a key for you with a device-code flow. You approve once in the browser; the agent never creates an account by itself. The same flow works over REST at POST /api/v1/agent/signup and /api/v1/agent/token. - ### start_signup The agent sends what data you want and why. It gets an approval link, an eight-character code and a device code that expires in 15 minutes. - ### You approve You open the link, sign in or create a free account, check the code and approve. Your password never passes through the agent. - ### finish_signup The agent polls every 5 seconds with the device code and receives the key exactly once. - ### answer_onboarding The agent answers the account's onboarding questions from what you told it, which unlocks the data tools. Both steps are free. ## Every tool Generated from the server's own tool list. Data tools also take user_request, the current task in one sentence. The account tools get_onboarding_questions, answer_onboarding and send_feedback come from the server core. | Tool | Key needed | What it does | | --- | --- | --- | | `registration_status` | Yes | Start here for a company: is this UEI or CAGE registered in SAM.gov, its status, expiration date, days to expiry, renewal window and exclusion flag. | | `get_entity` | Yes | The full SAM.gov registration of one entity by UEI or CAGE: names, status, dates, address city and state, NAICS, PSC, business types, SBA certifications. | | `search_entities` | Yes | Find registered entities by name, UEI, CAGE, NAICS, PSC, state, set-aside or business type, status, or registrations expiring within N days. | | `search_opportunities` | Yes | Find contract opportunities (bids) by keyword, NAICS, PSC, set-aside, agency, state, notice type, posted dates or deadline. | | `get_opportunity` | Yes (Pro and Scale) | One contract opportunity with its full description. Contracting-officer contacts as printed in the notice are included on Pro and Scale. | | `exclusion_check` | Yes | Is this UEI, CAGE code or exact name actively excluded from federal awards? Answers from the dated exclusions extract. | | `search_awards` | Yes | Find contract awards by recipient UEI, agency, NAICS, PSC, vehicle, fiscal year, or awards ending within N days. | | `recompetes` | Yes | Awards whose potential end date falls in the next months, the contracts most likely to be recompeted, by NAICS and agency. | | `naics_lookup` | Yes | One NAICS code (title, description, size standard), or a search of codes by words or prefix. | | `size_standard_check` | Yes | The SBA size standard for a NAICS code, and whether a business with these average annual receipts or employees counts as small. | | `labor_rates` | Yes | GSA schedule ceiling labor rates for a category, or with stats=true the count, quartiles and range. | | `teaming_partners` | Yes (Pro and Scale) | Active, unexcluded firms in a NAICS code for finding teaming partners; with small=true or a certification (8a, hubzone, wosb, edwosb, sdvosb), small businesses ranked by award volume. Pro and Scale. | | `expiring_registrations` | Yes | Firms whose SAM.gov registration expires within the next N days (default 30), soonest first, by NAICS and state. Individuals are left out. | | `search` | No | Search the public samgovapi.io lookup pages and docs: companies by name, UEI or CAGE, NAICS codes, open opportunities, guides and data fields. Needs no key. Then call fetch with a result id. | | `fetch` | No | The full text of one search result as markdown: a company's registration and awards, an opportunity, a NAICS code, a doc or a field. Needs no key. Quote the data-as-of date when you state a fact. | | `start_signup` | No | Get an API key for your user without them pasting one: send what they want and why, then show them approval_url and the code. They approve in the browser (creating a free account if needed). Then call finish_signup. Ask your user rather than guess. | | `finish_signup` | No | Collect the API key after your user approves: send the device_code from start_signup. Returns status pending until they approve; the key is returned once. | | `give_feedback` | No | Report wrong or missing data, a missing feature, a bug or a docs gap, or rate the last result 1 to 5. Kinds: wrong_data, missing_data, missing_feature, bug, docs, praise, other. No key needed and no credits; the team reads every one. | ## Files for agents - [/llms.txt](https://samgovapi.io/llms.txt)Short index for language models: offer, plans, quickstart, links. - [/llms-full.txt](https://samgovapi.io/llms-full.txt)The whole reference in one text file, including every guide's main snippet. - [/agents.md](https://samgovapi.io/agents.md)Agent setup: connect, get a key, first call, rules, credits. - [/skill.md](https://samgovapi.io/skill.md)A skill file: when to use the API and which call answers which question. - [/openapi.json](https://samgovapi.io/openapi.json)OpenAPI 3.1 document for every endpoint. - [/openapi-chatgpt.json](https://samgovapi.io/openapi-chatgpt.json)A trimmed OpenAPI document sized for GPT Actions. ## Recipes Federal contracting jobs done with an agent and this server, each with the exact prompt, the tool calls and a sample answer.[search_opportunitiesFind open bids for your NAICS code and set-aside](https://samgovapi.io/agents/recipes/find-open-bids-by-naics-and-set-aside)[registration_status + exclusion_checkCheck a teaming partner's SAM registration and exclusions](https://samgovapi.io/agents/recipes/check-teaming-partner-sam-registration-and-exclusions)[recompetesList recompetes in your NAICS in the next 12 months](https://samgovapi.io/agents/recipes/list-recompetes-in-my-naics)[registration_statusMonitor your SAM registration expiry](https://samgovapi.io/agents/recipes/monitor-my-sam-registration-expiry)[get_entity + search_awardsBuild a capability statement from your SAM record](https://samgovapi.io/agents/recipes/build-a-capability-statement-from-your-sam-record)[get_opportunitySummarize a solicitation](https://samgovapi.io/agents/recipes/summarize-a-solicitation)[get_opportunity + fetchFind the incumbent on a contract](https://samgovapi.io/agents/recipes/find-the-incumbent-on-a-contract)[labor_ratesCompare GSA labor rates for a labor category](https://samgovapi.io/agents/recipes/compare-gsa-labor-rates)[size_standard_checkCheck your size standard for a NAICS code](https://samgovapi.io/agents/recipes/check-your-size-standard-for-a-naics-code)[search_opportunitiesDaily bid digest with n8n](https://samgovapi.io/agents/recipes/daily-bid-digest-with-n8n)[registration_statusLook up CAGE codes in bulk](https://samgovapi.io/agents/recipes/bulk-cage-code-lookup)[get_entityVerify small business certifications](https://samgovapi.io/agents/recipes/verify-small-business-certifications)[teaming_partnersFind teaming partners by certification](https://samgovapi.io/agents/recipes/find-teaming-partners-by-certification)[search_awardsTrack a competitor's awards](https://samgovapi.io/agents/recipes/track-a-competitors-awards)[search_awardsSize a federal market by NAICS and agency](https://samgovapi.io/agents/recipes/size-a-federal-market-by-naics)[registration_statusAudit suppliers for expiring SAM registrations](https://samgovapi.io/agents/recipes/audit-a-supplier-list-for-expiring-registrations)[naics_lookup + search_opportunitiesFind the right NAICS code for your business](https://samgovapi.io/agents/recipes/find-the-right-naics-code-for-your-business)[search_opportunitiesFind sources sought notices to shape requirements](https://samgovapi.io/agents/recipes/sources-sought-notices-to-shape-requirements)[search_opportunitiesFind bids closing this week](https://samgovapi.io/agents/recipes/bids-closing-this-week)[search + search_opportunitiesFind PSC codes for what you sell](https://samgovapi.io/agents/recipes/find-psc-codes-for-what-you-sell)[search_awardsPull past performance for a proposal](https://samgovapi.io/agents/recipes/pull-past-performance-for-a-proposal)[exclusion_checkScreen a supplier list for exclusions](https://samgovapi.io/agents/recipes/screen-a-supplier-list-for-exclusions)[recompetesWeekly recompete sheet with Zapier](https://samgovapi.io/agents/recipes/weekly-recompete-sheet-with-zapier)[start_signup + finish_signupGet an API key through your agent](https://samgovapi.io/agents/recipes/get-an-api-key-through-your-agent)[search_awards + get_entityFind prime contractors to subcontract under](https://samgovapi.io/agents/recipes/find-prime-contractors-to-subcontract-under)[search_awards + search_opportunitiesResearch an agency before a capture](https://samgovapi.io/agents/recipes/research-an-agency-before-capture) ## Questions Which AI clients work with the samgovapi MCP server?Any client that speaks MCP over Streamable HTTP and can send an Authorization header: Claude Code, Claude Desktop and Claude.ai connectors, Codex, Cursor, VS Code, Windsurf, Zed, Cline, Continue, Gemini CLI, Goose, LibreChat, n8n and the agent frameworks listed above. ChatGPT's custom MCP servers connect without a key and get the keyless tools.Do MCP calls cost the same as REST calls?Yes. MCP data tools draw from the same monthly credits: 1 credit per record looked up by id; 1 credit per 100 rows returned, minimum 1. Keyless tools, signup, onboarding and feedback cost nothing.Does the server support SSE?No. It is stateless JSON over POST, the Streamable HTTP transport without a stream. A GET answers 405. Pick the Streamable HTTP or http transport in your client.Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.

---

HTML version: https://samgovapi.io/agents . Markdown: https://samgovapi.io/agents.md

Independent. Not affiliated with, endorsed by or sponsored by GSA, SAM.gov or any U.S. government agency. Registering in SAM.gov is free at sam.gov.

Get a free API key: https://samgovapi.io/sign-up?ref=ai-claudebot