Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Authorization not required, issuer https://matchawards.com
Authorization not required, issuer https://matchawards.com
Authorization not required, issuer https://matchawards.com
Added "my_matches" (10 tools before, 11 now)
My matches — Use this when the user asks for their own matches: open contracts for their business. It needs a linked MatchAwards account and uses that account's NAICS codes and state; without a linked account it asks the user to link one. Options: type (federal or state), ignore_state (true: every state), only_my_set_aside (true: only notices set aside for the account's set-aside; by default open competitions are included too), limit (1 to 50, default 20). If has_more is true, call again with cursor=next_cursor and the same options. Print each result's url, and sam_url for federal notices, as markdown l…
Changed the definition of "assess_opportunity" and "get_opportunity"
Use this when the user askswhetheriftoonebidopportunityonisoneaopportunitygood fit for them, whether to bid, or wants aqualificationbid briefon it: days left, set-aside,AI fit notesmatch
Certificate changed, valid to 2027-01-17
Added "assess_opportunity", "find_teaming_partners", "get_company" and 3 more; removed "find_contacts" and "search_by_naics"; changed the definition of "get_opportunity", "search_contracts", "search_grants" and 1 more (6 tools before, 10 now)
before
—after
Get opportunity detailsGetUse this when thefulluserrecordwants the details of oneopportunitysearchby
Certificate recorded, valid to 2026-11-19
Authorization not required
Unknown → Live
First tool surface recorded: 6 tools (server version 0.3.0)
https://matchawards.com/mcp (mcp_streamable_http) — from mcp_registry
pypi:matchawards-mcp (package_pypi) — from pypi, with the record
Showing the latest 13 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨45 unchanged words⟩ when MatchAwards has them, ai: AI-generated noteson fit,(subcontracting and large-prime angles) and a summary. AI text is AI-generated: ⟨23 unchanged words⟩ not use for searching (search_contracts, search_grants, search_jobs), for fit or bid/no-bid questions (assess_opportunity) or for contact details beyond the published names and titles.
{"additionalProperties$defs":{"AiNotes":{"description":"AI-generated notes MatchAwards wrote when it imported the notice. Every field is AI-generated text.","properties":{"fit":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"description":"Who this opportunity suits.","title":"Fit"},"large_prime":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"description":"Angles for large prime contractors.","title":"Large Prime"},"reasoning":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"title":"Reasoning"},"subcontracting":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"description":"Angles for subcontractors.","title":"Subcontracting"},"summary":{"anyOf":[{"$ref":"#/$defs/AiSummary"},{"type":"null"}],"default":null}},"title":"AiNotes","type":"object"},"AiSummary":{"properties":{"nft_advantage":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"title":"Nft Advantage"},"nft_insight":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"title":"Nft Insight"},"nft_title":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"default":null,"title":"Nft Title"}},"title":"AiSummary","type":"object"},"Contact":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"}},"title":"Contact","type":"object"},"Naics":{"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Code"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"}},"title":"Naics","type":"object"}},"properties":{"agency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Agency"},"agency_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The agency's MatchAwards id.","title":"Agency Id"},"ai":{"anyOf":[{"$ref":"#/$defs/AiNotes"},{"type":"null"}],"default":null,"description":"AI-generated notes on this opportunity, or null. Label them as AI-generated when you show or quote them."},"ai_matched_naics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only when you filtered by naics: requested codes this contract notice matched only because MatchAwards' AI suggested them, not its own codes. Call such a match AI-suggested.","title":"Ai Matched Naics"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"As Of"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"contacts":{"description":"Published points of contact; [] if none.","items":{"$ref":"#/$defs/Contact"},"title":"Contacts","type":"array"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Up to 2000 characters.","title":"Description"},"id":{"description":"Pass to get_opportunity for the description and contacts.","title":"Id","type":"string"},"matched_naics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only when you filtered by naics: the requested codes this record carries: its own code (in naics) or, for a grant or job, another code of its program or occupation.","title":"Matched Naics"},"naics":{"anyOf":[{"$ref":"#/$defs/Naics"},{"type":"null"}],"default":null,"description":"On state notices (type state) the naics code itself is AI-assigned."},"no_fixed_deadline":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"true: the deadline is a placeholder date.","title":"get_opportunityDictOutputNo Fixed Deadline"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"},"office":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Office"},"posted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date, YYYY-MM-DD.","title":"Posted At"},"response_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date, YYYY-MM-DD; null if none.","title":"Response Deadline"},"sam_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The SAM.gov notice (federal only). Show it as a markdown link.","title":"Sam Url"},"set_aside":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Set Aside"},"solicitation_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Solicitation Number"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"State"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"federal, state, grant or job.","title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The posting on matchawards.com. Show it as a markdown link.","title":"Url"}},"required":["id"],"title":"OpportunityDetail","type":"object"}
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}
before
—after
Search government contractsSearch US federal and state government contract opportunities (bids, RFPs, solicitations).Use this when the user wantscontracts to bidUSon.federalReturnsor{as_of,stateresults,governmenthas_more,contractnext_cursor}; eachopportunitiesresulttohasbidid,on:typebids,titleRFPs,agencysolicitations,office,set-asides. Filters: naics{code, title}, set_aside, state, city, posted_at, response_deadline, url(matchawards.com), sam_urlupandtosolicitation_number. Filters:10naicscodes), state, keyword (title only), set_aside (federal only), type (federal or state), posted_within_days (1 to 180),open (default true), agency (a name; the note says which agency it matched), limit (1 to 50,cursor.default 20). If has_more is true, call again with cursor=next_cursor and thesame filters. Example: naics="238160", state="VA", keyword="roof".ForgrantsPassuseseveralsearch_grantsNAICS codes in one call. Print each result's url, and sam_url for federal notices, as markdown links. Do not use for grants (search_grants), jobssearch_jobs.(search_jobs) or one result's details (get_opportunity). When you are done searching, call show_results once with the best ids; it shows them as a card the user can pick from.
{"properties":{"agency":{"anyOf":[{"maxLength":100,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Agency name, e.g. 'Department of Veterans Affairs'; matched to the closest MatchAwards agency, which the result note names.","title":"Agency"},"cursor":{"anyOf":[{"type":"string ⟨90 unchanged words⟩ codes, comma-separated, e.g. '236220' or '541511,541512'. A notice matches on its own codes (matched_naics says which), or through a code MatchAwards' AI suggested: that one is listed in ai_matched_naics, so call the match AI-suggested. Unknown codes are ignored.","title":"Naics ⟨152 unchanged words⟩
{"additionalProperties$defs":{"Naics":{"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Code"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"}},"title":"Naics","type":"object"},"OpportunityRow":{"description":"One search result. Jobs fill title, agency (the employer), state, city, posted_at and url only.","properties":{"agency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Agency"},"agency_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The agency's MatchAwards id.","title":"Agency Id"},"ai_matched_naics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only when you filtered by naics: requested codes this contract notice matched only because MatchAwards' AI suggested them, not its own codes. Call such a match AI-suggested.","title":"Ai Matched Naics"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"id":{"description":"Pass to get_opportunity for the description and contacts.","title":"Id","type":"string"},"matched_naics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only when you filtered by naics: the requested codes this record carries: its own code (in naics) or, for a grant or job, another code of its program or occupation.","title":"Matched Naics"},"naics":{"anyOf":[{"$ref":"#/$defs/Naics"},{"type":"null"}],"default":null,"description":"On state notices (type state) the naics code itself is AI-assigned."},"no_fixed_deadline":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"true: the deadline is a placeholder date.","title":"search_contractsDictOutputNo Fixed Deadline"},"office":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Office"},"posted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date, YYYY-MM-DD.","title":"Posted At"},"response_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date, YYYY-MM-DD; null if none.","title":"Response Deadline"},"sam_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The SAM.gov notice (federal only). Show it as a markdown link.","title":"Sam Url"},"set_aside":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Set Aside"},"solicitation_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Solicitation Number"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"State"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"federal, state, grant or job.","title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The posting on matchawards.com. Show it as a markdown link.","title":"Url"}},"required":["id"],"title":"OpportunityRow","type":"object"}},"properties":{"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When the API generated the results (ISO time).","title":"As Of"},"has_more":{"description":"true: call again with cursor=next_cursor and the same filters.","title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Next Cursor"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"},"results":{"items":{"$ref":"#/$defs/OpportunityRow"},"title":"Results","type":"array"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Set when paging stopped early; the results so far are still valid.","title":"Warning"}},"required":["results","has_more"],"title":"SearchResult
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}
before
—after
Search grantsSearch US federal grant and funding opportunities.Use this when the user wants US federal grants or funding,notopportunities. Filters:contracts.naicsReturns(up{as_of,toresults,10has_morecodes),next_cursor};each result has id,keyword (title,agency, naics, posted_atonly),response_deadline and a matchawards.com url. Filters:posted_within_daysnaics,(1keyword,toposted_within_days180), open (default true: open grants of any age), limit, cursor.Grant(1noticestocarry50,nodefaultstate,20).soGranttherenoticesiscarry nostate filter.state. If has_more is true, call again withcursor=next_cursor and the same filters. Example: keyword="broadband". Pass several NAICS codes in one call. Open status may lag for grants that closed recently, so check response_deadline. Print each result's url as a markdown link. Do not use for contracts to bid on (search_contracts) ornaics="541715"jobs (search_jobs). When you are done searching, call show_results once with the best ids; it shows them as a card the user can pick from.
⟨95 unchanged words⟩ codes, comma-separated, e.g. '236220' or '541511,541512'. A record matches on its own codes (matched_naics says which). Unknown codes are ignored.","title":"Naics" ⟨73 unchanged words⟩
{"additionalProperties$defs":{"Naics":{"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Code"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"}},"title":"Naics","type":"object"},"OpportunityRow":{"description":"One search result. Jobs fill title, agency (the employer), state, city, posted_at and url only.","properties":{"agency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Agency"},"agency_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The agency's MatchAwards id.","title":"Agency Id"},"ai_matched_naics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only when you filtered by naics: requested codes this contract notice matched only because MatchAwards' AI suggested them, not its own codes. Call such a match AI-suggested.","title":"Ai Matched Naics"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"id":{"description":"Pass to get_opportunity for the description and contacts.","title":"Id","type":"string"},"matched_naics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only when you filtered by naics: the requested codes this record carries: its own code (in naics) or, for a grant or job, another code of its program or occupation.","title":"Matched Naics"},"naics":{"anyOf":[{"$ref":"#/$defs/Naics"},{"type":"null"}],"default":null,"description":"On state notices (type state) the naics code itself is AI-assigned."},"no_fixed_deadline":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"true: the deadline is a placeholder date.","title":"search_grantsDictOutputNo Fixed Deadline"},"office":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Office"},"posted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date, YYYY-MM-DD.","title":"Posted At"},"response_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date, YYYY-MM-DD; null if none.","title":"Response Deadline"},"sam_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The SAM.gov notice (federal only). Show it as a markdown link.","title":"Sam Url"},"set_aside":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Set Aside"},"solicitation_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Solicitation Number"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"State"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"federal, state, grant or job.","title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The posting on matchawards.com. Show it as a markdown link.","title":"Url"}},"required":["id"],"title":"OpportunityRow","type":"object"}},"properties":{"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When the API generated the results (ISO time).","title":"As Of"},"has_more":{"description":"true: call again with cursor=next_cursor and the same filters.","title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Next Cursor"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"},"results":{"items":{"$ref":"#/$defs/OpportunityRow"},"title":"Results","type":"array"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Set when paging stopped early; the results so far are still valid.","title":"Warning"}},"required":["results","has_more"],"title":"SearchResult
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}
before
—after
Search jobsSearch job postings from the last 30 days listed on MatchAwards.Use this when the user is looking for a job, or for hiring signals,not foramongcontractspostingsorfromgrants. Returnsthe{as_of,lastresults,30has_more,days. Filters:next_cursor};naicseach(upresulttohas10idcodes),titlestate,agencykeyword (thetitleemployeronly),state,city, posted_atposted_within_daysand(postedawithinmatchawards.comtheurl;lastother1fieldstoare30null.days,Filters:defaultnaics30),statelimit (1 to 50,keyworddefault 20). Rows carry title,posted_within_daysagency (up tothe30employer),limitstate,cursor.city, posted_at and url. If has_more is true, call again withcursor=next_cursor and the same filters. Example: keyword="electrician", state="TX",.posted_within_days=7.Pass several NAICS codes in one call. Print each result's url as a markdown link. Do not use for contracts (search_contracts) or grants (search_grants).
⟨95 unchanged words⟩ codes, comma-separated, e.g. '236220' or '541511,541512'. A record matches on its own codes (matched_naics says which). Unknown codes are ignored.","title":"Naics"},"posted_within_days":{"default":30,"description":"Only jobs postedinwithin the last N days, 1 to30.30 (default 30).","maximum":30,"minimum":1,"title ⟨42 unchanged words⟩
{"additionalProperties$defs":{"Naics":{"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Code"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"}},"title":"Naics","type":"object"},"OpportunityRow":{"description":"One search result. Jobs fill title, agency (the employer), state, city, posted_at and url only.","properties":{"agency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Agency"},"agency_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The agency's MatchAwards id.","title":"Agency Id"},"ai_matched_naics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only when you filtered by naics: requested codes this contract notice matched only because MatchAwards' AI suggested them, not its own codes. Call such a match AI-suggested.","title":"Ai Matched Naics"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"City"},"id":{"description":"Pass to get_opportunity for the description and contacts.","title":"Id","type":"string"},"matched_naics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Only when you filtered by naics: the requested codes this record carries: its own code (in naics) or, for a grant or job, another code of its program or occupation.","title":"Matched Naics"},"naics":{"anyOf":[{"$ref":"#/$defs/Naics"},{"type":"null"}],"default":null,"description":"On state notices (type state) the naics code itself is AI-assigned."},"no_fixed_deadline":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"true: the deadline is a placeholder date.","title":"search_jobsDictOutputNo Fixed Deadline"},"office":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Office"},"posted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date, YYYY-MM-DD.","title":"Posted At"},"response_deadline":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Date, YYYY-MM-DD; null if none.","title":"Response Deadline"},"sam_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The SAM.gov notice (federal only). Show it as a markdown link.","title":"Sam Url"},"set_aside":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Set Aside"},"solicitation_number":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Solicitation Number"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"State"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"federal, state, grant or job.","title":"Type"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"The posting on matchawards.com. Show it as a markdown link.","title":"Url"}},"required":["id"],"title":"OpportunityRow","type":"object"}},"properties":{"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"When the API generated the results (ISO time).","title":"As Of"},"has_more":{"description":"true: call again with cursor=next_cursor and the same filters.","title":"Has More","type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Next Cursor"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"},"results":{"items":{"$ref":"#/$defs/OpportunityRow"},"title":"Results","type":"array"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Set when paging stopped early; the results so far are still valid.","title":"Warning"}},"required":["results","has_more"],"title":"SearchResult
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}
Assess an opportunity — Use this when the user asks whether to bid on one opportunity, or wants a qualification brief on it: days left, set-aside, AI fit notes, similar past awards, the firms that typically win such work and the usual award value. Pass the id from a search result, and optionally my_naics (up to 10 codes) and my_set_aside to check the fit. Similar awards come from MatchAwards' award records for the same NAICS at the same agency, or at all agencies when that agency has none (basis says which); sample gives the dates covered and whether every matching record was read, so state that span rather than a …
Find teaming partners — Use this when the user wants possible teaming partners, subcontractors or primes for one opportunity: firms that won similar awards in the same state or at the same agency. Pass the id from a search result, and optionally role (sub, prime or any). Returns up to 10 firms from MatchAwards' award records (same NAICS in the opportunity's state, then at its agency, else anywhere; sample gives the dates covered and whether every matching record was read), ranked by how many similar awards they won, each with a why line; get_company(uei) shows the history of a firm with a uei. No contact details. A…
Get company award history — Use this when the user wants one firm's government award history and its UEI is known, e.g. from a search_awards row. Returns the firm's name and other spellings, location (city, state, country), totals for contract and grant awards, first and last award dates, top NAICS codes and agencies, and its 10 most recent awards. No contact details. Award records may be incomplete, so say so. Example: uei="C3KXNLTAAY98". Print each recent award's url and source_url as markdown links. Do not use for finding firms by name or NAICS (search_awards) or for contact details (none are available).
Look up NAICS codes — Use this when the user describes a line of work in words and a NAICS code is needed, or asks what a code or code prefix covers. query is words (2 to 100 characters; common terms such as cybersecurity or janitorial list their usual codes first) or 2 to 6 digits (every six-digit code starting with them). limit is 1 to 25, default 10. Pass the codes as naics to search_contracts, search_grants, search_jobs or search_awards. Print each opportunities_url that is set as a markdown link. Do not use for searching opportunities or awards themselves (the search tools take the codes).
Search past awards — Use this when the user asks who won government contracts or grants: past awards by NAICS, agency, state, awardee name or UEI, with amounts and dates. Filters: type (contract_award, grant_award or any), naics (up to 10 codes), agency (a name; the note says which agency it matched), state, awardee (part of a name), uei, keyword (matched in the title; a grant award's title is its recipient's name), awarded_within_days (1 to 1095, default 365), limit (1 to 50, default 20). If has_more is true, call again with cursor=next_cursor and the same filters. Example: naics="541512", agency="Department of…
Show results — Use this last, after searching, to show the user the opportunities you picked as a card. Pass up to 10 ids from search_contracts or search_grants results, best first. Keep your reply to a short summary; the card shows the rows. Ids from search_jobs or search_awards are not shown. Do not use to search (search_contracts, search_grants) or for one result's details (get_opportunity).
Get only the published points of contact for one opportunity by its id. Use this when the user asks who to contact about a result. Returns {id, title, url, contacts}, where contacts is [{name, title}] as the public matchawards.com page shows them; an empty list means none are published. Example: id="abc123".
List the newest opportunities for one or more NAICS industry codes. Use this when the user gives NAICS codes and nothing else. Returns up to 20 results, {as_of, results, has_more, next_cursor}, each with a matchawards.com url. Filters: naics (required), type (contract, federal, state, grant or job), cursor (next_cursor of the previous call, same naics and type). For keyword, state or other filters use search_contracts, search_grants or search_jobs. Example: naics="541511,541512", type="federal".