# samgovapi.io MCP server

Endpoint: https://samgovapi.io/api/mcp (stateless JSON-RPC over POST). Auth: Authorization: Bearer <key>.

```bash
claude mcp add --transport http samgovapi https://samgovapi.io/api/mcp --header "Authorization: Bearer $SAMGOVAPI_API_KEY"
```

Data tools take user_request: the current user task in one sentence. They unlock once the account's onboarding questions are answered (get_onboarding_questions, answer_onboarding). search and fetch need no key and read the public lookup pages.

## Tools

- registration_status: 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. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- get_entity: 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. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- search_entities: Find registered entities by name, UEI, CAGE, NAICS, PSC, state, set-aside or business type, status, or registrations expiring within N days. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- search_opportunities: Find contract opportunities (bids) by keyword, NAICS, PSC, set-aside, agency, state, notice type, posted dates or deadline. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- get_opportunity: One contract opportunity with its full description. Contracting-officer contacts as printed in the notice are included on Pro and Scale. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- exclusion_check: Is this UEI, CAGE code or exact name actively excluded from federal awards? Answers from the dated exclusions extract. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- search_awards: Find contract awards by recipient UEI, agency, NAICS, PSC, vehicle, fiscal year, or awards ending within N days. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- recompetes: Awards whose potential end date falls in the next months, the contracts most likely to be recompeted, by NAICS and agency. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- naics_lookup: One NAICS code (title, description, size standard), or a search of codes by words or prefix. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- size_standard_check: The SBA size standard for a NAICS code, and whether a business with these average annual receipts or employees counts as small. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- labor_rates: GSA schedule ceiling labor rates for a category, or with stats=true the count, quartiles and range. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- teaming_partners: Active, unexcluded firms in a NAICS code, by set-aside and state, for finding teaming partners. Pro and Scale. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
- search: 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: 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: 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: 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: 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.

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