{"serverId":"mcp-registry/io.github.samgovapi/samgovapi","tools":[{"name":"cancel_subscription","fixed":{"name":"cancel_subscription","description":"Cancel your user's paid plan at the end of the current billing period. Only call this when your user asked to cancel. A reason is required: ask your user why they are cancelling and pass their answer; never pick a reason for them. Reasons: got_what_i_needed (I got the data I needed), too_expensive (Too expensive), missing_data (Missing data or features I need), reliability (Errors or slow responses), not_using (Not using it enough), switched (Switched to another service), other (Something else).","inputSchema":{"type":"object","required":["reason"],"properties":{"client":{"type":"string","description":"Your name, such as Claude Code or Cursor."},"reason":{"enum":["got_what_i_needed","too_expensive","missing_data","reliability","not_using","switched","other"],"type":"string","description":"Why your user is cancelling, in their words mapped to one id. Ask them; never guess."},"comment":{"type":"string","maxLength":500,"description":"Your user's own words about why. Required when reason is other."}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":294,"tokensAfter":294},{"name":"create_alerts","fixed":{"name":"create_alerts","description":"Create one of your Alerts.","inputSchema":{"type":"object","required":["name","kind","user_request"],"properties":{"psc":{"type":"string","description":"Comma-separated product and service codes"},"uei":{"type":"string","description":"12-character Unique Entity ID to watch"},"kind":{"enum":["registration_expiry","opportunity_match","recompete","exclusion"],"type":"string","description":"Which change fires the alert"},"name":{"type":"string","description":"What this alert watches"},"naics":{"type":"string","description":"Comma-separated 6-digit NAICS codes for opportunity and recompete alerts"},"agency":{"type":"string","description":"Department or agency name to limit matches to"},"set_aside":{"type":"string","description":"Set-aside code such as SBA"},"user_request":{"type":"string","description":"The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":279,"tokensAfter":279},{"name":"delete_alerts","fixed":{"name":"delete_alerts","description":"Delete one of your Alerts. Cannot be undone, so confirm with your user first.","inputSchema":{"type":"object","required":["id","user_request"],"properties":{"id":{"type":"string"},"user_request":{"type":"string","description":"The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":109,"tokensAfter":109},{"name":"exclusion_check","fixed":{"name":"exclusion_check","description":"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.","inputSchema":{"type":"object","required":["q","user_request"],"properties":{"q":{"type":"string","description":"UEI, CAGE code or exact name."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":159,"tokensAfter":159},{"name":"fetch","fixed":{"name":"fetch","description":"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.","inputSchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"An id from search, such as entity:ABCDEFGH1234 or naics:541512."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":110,"tokensAfter":110},{"name":"get_alerts","fixed":{"name":"get_alerts","description":"Read one of your Alerts by id.","inputSchema":{"type":"object","required":["id","user_request"],"properties":{"id":{"type":"string"},"user_request":{"type":"string","description":"The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":95,"tokensAfter":95},{"name":"get_entity","fixed":{"name":"get_entity","description":"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.","inputSchema":{"type":"object","required":["user_request"],"properties":{"uei":{"type":"string","description":"12-character UEI."},"cage":{"type":"string","description":"5-character CAGE code, if there is no UEI."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":186,"tokensAfter":186},{"name":"get_onboarding_questions","fixed":{"name":"get_onboarding_questions","description":"The questions that finish setting up your user's account, with their ids and options. With a key, also the answers already given. Costs no quota.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":69,"tokensAfter":69},{"name":"get_opportunity","fixed":{"name":"get_opportunity","description":"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.","inputSchema":{"type":"object","required":["notice_id","user_request"],"properties":{"notice_id":{"type":"string","description":"SAM.gov notice ID."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":165,"tokensAfter":165},{"name":"get_sample_data","fixed":{"name":"get_sample_data","description":"Real rows from any dataset with no key: registration status, entities, opportunities, awards, exclusions, recompetes, NAICS, labor rates or expiring registrations, up to 5 rows a call, same fields as the API. Use it to try the data before your user signs up (10,000 free credits a month, 120 requests a minute, no card).","inputSchema":{"type":"object","required":["dataset"],"properties":{"params":{"type":"object","description":"Filters for that dataset, such as {\"q\":\"lockheed\"} or {\"naics\":\"541512\",\"open\":\"true\"}. Codes are matched in any case."},"dataset":{"enum":["registration-status","entities","opportunities","awards","exclusions","recompetes","naics","labor-rates","expiring-registrations"],"type":"string","description":"Dataset name, any case."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":227,"tokensAfter":227},{"name":"get_subscription","fixed":{"name":"get_subscription","description":"Your user's plan and subscription status, including a scheduled cancellation, and the reasons cancel_subscription accepts. Costs no quota.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":64,"tokensAfter":64},{"name":"list_alerts","fixed":{"name":"list_alerts","description":"List Alerts. A saved watch on SAM.gov data, such as a registration expiry for a UEI or new opportunities matching your NAICS and PSC codes.","inputSchema":{"type":"object","required":["user_request"],"properties":{"limit":{"type":"number"},"offset":{"type":"number"},"user_request":{"type":"string","description":"The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":132,"tokensAfter":132},{"name":"naics_lookup","fixed":{"name":"naics_lookup","description":"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.","inputSchema":{"type":"object","required":["user_request"],"properties":{"q":{"type":"string","description":"Words or a code prefix to search."},"code":{"type":"string","description":"NAICS code, such as 541512."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":170,"tokensAfter":170},{"name":"registration_status","fixed":{"name":"registration_status","description":"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.","inputSchema":{"type":"object","required":["id","user_request"],"properties":{"id":{"type":"string","description":"A 12-character UEI or a 5-character CAGE code."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":173,"tokensAfter":173},{"name":"search","fixed":{"name":"search","description":"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.","inputSchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Words to look for: a company name, a UEI, a NAICS code or a question."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":113,"tokensAfter":113},{"name":"search_awards","fixed":{"name":"search_awards","description":"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.","inputSchema":{"type":"object","required":["user_request"],"properties":{"psc":{"type":"string","description":"PSC code."},"limit":{"type":"integer","description":"Rows to return, 1 to 100. Default 25."},"naics":{"type":"string","description":"NAICS code or prefix."},"agency":{"type":"string","description":"Awarding agency name."},"cursor":{"type":"string","description":"next_cursor from the previous answer."},"vehicle":{"type":"string","description":"Contract vehicle name."},"action_to":{"type":"string","description":"YYYY-MM-DD."},"recipient":{"type":"string","description":"Recipient name contains."},"min_amount":{"type":"number","description":"Obligated at least this many dollars."},"action_from":{"type":"string","description":"YYYY-MM-DD."},"agency_code":{"type":"string","description":"Awarding agency or sub-agency code."},"fiscal_year":{"type":"integer","description":"Fiscal year."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."},"recipient_uei":{"type":"string","description":"Recipient UEI."},"expiring_within_days":{"type":"integer","description":"Potential end date within this many days."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":412,"tokensAfter":412},{"name":"search_entities","fixed":{"name":"search_entities","description":"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.","inputSchema":{"type":"object","required":["user_request"],"properties":{"q":{"type":"string","description":"Name, UEI or CAGE."},"psc":{"type":"string","description":"PSC code."},"limit":{"type":"integer","description":"Rows to return, 1 to 100. Default 25."},"naics":{"type":"string","description":"6-digit NAICS code."},"state":{"type":"string","description":"2-letter state."},"cursor":{"type":"string","description":"next_cursor from the previous answer."},"status":{"type":"string","description":"active or expired."},"set_aside":{"type":"string","description":"Business type or SBA program code, such as 8A."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."},"business_type":{"type":"string","description":"SAM.gov business type code."},"expiring_within_days":{"type":"integer","description":"Registrations expiring within this many days."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":346,"tokensAfter":346},{"name":"search_opportunities","fixed":{"name":"search_opportunities","description":"Find contract opportunities (bids) by keyword, NAICS, PSC, set-aside, agency, state, notice type, posted dates or deadline. To have new and changed notices pushed instead of polling, any key can open the WebSocket change stream at wss://stream.samgovapi.io/v1/stream (Free: 5 minutes late; paid plans: real time). 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.","inputSchema":{"type":"object","required":["user_request"],"properties":{"q":{"type":"string","description":"Title words or solicitation number."},"psc":{"type":"string","description":"PSC code."},"open":{"type":"boolean","description":"true for open bids: deadline not passed, award notices left out."},"sort":{"type":"string","description":"posted (newest first) or deadline (closing soonest)."},"type":{"type":"string","description":"Notice type."},"limit":{"type":"integer","description":"Rows to return, 1 to 100. Default 25."},"naics":{"type":"string","description":"NAICS code or prefix."},"state":{"type":"string","description":"Place of performance state."},"active":{"type":"boolean","description":"true for open notices only."},"agency":{"type":"string","description":"Department or sub-tier name."},"cursor":{"type":"string","description":"next_cursor from the previous answer."},"posted_to":{"type":"string","description":"YYYY-MM-DD."},"set_aside":{"type":"string","description":"Set-aside code, such as SBA, 8A, WOSB, SDVOSBC."},"agency_code":{"type":"string","description":"Department or sub-tier code from the agencies list."},"deadline_to":{"type":"string","description":"Response deadline on or before, YYYY-MM-DD."},"posted_from":{"type":"string","description":"YYYY-MM-DD."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."},"deadline_from":{"type":"string","description":"YYYY-MM-DD."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":551,"tokensAfter":551},{"name":"send_feedback","fixed":{"name":"send_feedback","description":"Tell the team what is missing or wrong. The team reads every one. Costs no quota.","inputSchema":{"type":"object","required":["kind","message"],"properties":{"kind":{"enum":["missing_feature","missing_data","bug","other"],"type":"string"},"contact":{"type":"string"},"message":{"type":"string"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":94,"tokensAfter":94},{"name":"size_standard_check","fixed":{"name":"size_standard_check","description":"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.","inputSchema":{"type":"object","required":["code","user_request"],"properties":{"code":{"type":"string","description":"6-digit NAICS code."},"employees":{"type":"number","description":"Average employees."},"revenue_usd":{"type":"number","description":"Average annual receipts in dollars."},"user_request":{"type":"string","description":"The current user task in one sentence. Leave out secrets and personal data."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":202,"tokensAfter":202},{"name":"start_signup","fixed":{"name":"start_signup","description":"Get an API key for your user without them pasting one: send what they want and why. With their email you get api_key back at once, a starter key with 250 credits. Show them approval_url and the code; when they approve in the browser (creating a free account if needed) the same key moves to the free plan. Then call finish_signup. Ask your user rather than guess.","inputSchema":{"type":"object","required":["data_wanted","use_case"],"properties":{"agent":{"type":"string","description":"Your agent or client name."},"email":{"type":"string","description":"Your user's email, for an instant starter key. Optional."},"found_us":{"type":"string","description":"How your user says they found this API, if they said."},"use_case":{"type":"string","description":"What they will do with it, 3 to 1000 characters."},"data_wanted":{"type":"string","description":"What SAM.gov or contracting data they want, 3 to 1000 characters."}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":268,"tokensAfter":268},{"name":"update_alerts","fixed":{"name":"update_alerts","description":"Change fields on one of your Alerts.","inputSchema":{"type":"object","required":["id","user_request"],"properties":{"id":{"type":"string"},"psc":{"type":"string","description":"Comma-separated product and service codes"},"uei":{"type":"string","description":"12-character Unique Entity ID to watch"},"kind":{"enum":["registration_expiry","opportunity_match","recompete","exclusion"],"type":"string","description":"Which change fires the alert"},"name":{"type":"string","description":"What this alert watches"},"naics":{"type":"string","description":"Comma-separated 6-digit NAICS codes for opportunity and recompete alerts"},"agency":{"type":"string","description":"Department or agency name to limit matches to"},"set_aside":{"type":"string","description":"Set-aside code such as SBA"},"user_request":{"type":"string","description":"The current user task in one sentence. Saved so the team can decide what to build. Leave out secrets and personal data."}},"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":285,"tokensAfter":285}],"toolsChanged":22,"tokensSaved":0,"todo":[{"tool":"delete_alerts","params":["id"]},{"tool":"get_alerts","params":["id"]},{"tool":"list_alerts","params":["limit","offset"]},{"tool":"send_feedback","params":["kind","contact","message"]},{"tool":"update_alerts","params":["id"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}