MatchAwards

io.github.matchawardsv0.1.0更新於 Oct 8, 2026

Search US government contracts, grants and jobs from matchawards.com. Read-only, no key.

已驗證STDIO僅桌面Business & CommerceWeb Search & Scraping

概覽

AI 產生的概覽

讓助理搜尋 matchawards.com 上的美國政府合約、補助與職缺，工具為唯讀，且不需要帳號。

功能
透過六個唯讀工具存取 MatchAwards 的公開資訊。search_contracts 回傳聯邦與州政府合約機會，可依 NAICS、州、關鍵字、保留類別、僅聯邦或僅州、最近 N 天發布、僅開放中以及分頁篩選。search_grants 涵蓋聯邦補助與資金公告，search_jobs 涵蓋最近 30 天的職缺，search_by_naics 回傳最多 10 個 NAICS 代碼下某一類型的最新機會。get_opportunity 回傳單一機會的完整紀錄，包含說明、截止日期、機關與聯絡人，find_contacts 只回傳已公布的聯絡人。結果依最新排序，附帶 matchawards.com 連結，has_more 為真時可用 cursor 翻頁。
適用情境
適合讓助理查詢正在開放的美國政府合約、補助或職缺機會，依 NAICS 代碼、州或發布時間篩選，並取得某項招標的詳細資料或聯絡人姓名。適用於快速調查與尋找線索，而非管理申請流程。
執行需求
以 stdio 方式在本機執行，透過 uvx 啟動（uvx 隨 uv 提供），因此需要 uv 提供的 Python 工具鏈。不需要帳號、API 金鑰或身分驗證。需要連線至 matchawards.com 的網路。選用環境變數 MATCHAWARDS_API_BASE 可覆寫 API 基礎網址，除開發用途外應保持未設定。
安裝前請注意
唯讀：僅搜尋與取得資訊，不會寫入、傳送或刪除資料。不會要求任何憑證或密鑰。請求會送往 matchawards.com，因此搜尋詞與篩選條件會傳給該第三方。API 依 IP 限流（每分鐘 60 次請求，5 秒內突發 20 次），篩選條件較窄的搜尋最多使用三次請求，頻繁使用可能回傳限流錯誤。回傳的聯絡資訊為已公布的聯絡人資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 MatchAwards，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MatchAwards MCP server

MatchAwards gives AI agents direct access to continuously updated government and business contracts, grants, jobs, awards and collaboration opportunities.

This is the Model Context Protocol server for MatchAwards. It lets Claude, Cursor, VS Code and other MCP clients search US government contract opportunities, grants and jobs. It only reads data, and it needs no account and no API key.

Tools

ToolWhat it returnsExample prompt
search_contractsFederal and state contract opportunities. Filters: NAICS, state, keyword, set-aside, federal or state only, posted within N days, open only, paging."Find open roofing contracts in Virginia posted in the last week."
search_grantsFederal grant and funding opportunities. Filters: NAICS, keyword, posted within N days, open only, paging (grant notices carry no state)."Are there open broadband grants?"
search_jobsJob postings from the last 30 days. Filters: NAICS, state, keyword, posted within N days, paging."Show electrician jobs in Texas from the last 7 days."
search_by_naicsThe newest opportunities for up to 10 NAICS codes, of one type: contract, federal, state, grant or job."What is new for NAICS 541511 and 541512 at the federal level?"
get_opportunityThe full record of one opportunity: description, deadline, agency and contacts (name and title)."Tell me more about the second result."
find_contactsOnly the published points of contact for one opportunity."Who do I contact about that solicitation?"

Every result carries a url on matchawards.com, and the server asks the model to show it to you as a link.

Install

The server runs with uvx, which comes with uv.

Claude Desktop

Add this to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json), then restart Claude Desktop:

json
{  "mcpServers": {    "matchawards": {      "command": "uvx",      "args": ["matchawards-mcp"]    }  }}

Claude Code

bash
claude mcp add matchawards -- uvx matchawards-mcp

Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

json
{  "mcpServers": {    "matchawards": {      "command": "uvx",      "args": ["matchawards-mcp"]    }  }}

VS Code

Add this to .vscode/mcp.json in your workspace:

json
{  "servers": {    "matchawards": {      "type": "stdio",      "command": "uvx",      "args": ["matchawards-mcp"]    }  }}

Other clients

Any MCP client that can start a stdio server works. The command is uvx matchawards-mcp.

Configuration

VariableDefaultPurpose
MATCHAWARDS_API_BASEhttps://matchawards.comAPI base URL. Change it only for development.

Data

The data is US federal and state contract opportunities, grants and jobs from matchawards.com. Only public posts are returned, and each result links back to its page on matchawards.com.

  • Contract and grant searches return open items by default: a response deadline of today or later, US Eastern. An item with no deadline counts as closed.
  • Job search covers the last 30 days.
  • Results come newest first. When has_more is true, the model can ask for the next page with cursor.
  • If the first request of a search fails, the tool returns an error. If a later page fails, the tool returns the rows it already has, with a warning that says why it stopped.
  • The API is rate-limited per IP: 60 requests per minute, plus a burst limit of 20 requests per 5 seconds. One search call can use up to three requests when the filters are narrow and results are sparse. When the limit is reached, the tool returns an error that tells the model how many seconds to wait.

Development

bash
python -m venv .venv.venv/bin/pip install -e ".[test]".venv/bin/pytest

The tests make no network calls.

License

MIT. See LICENSE.

來源：README.md，提交 3c22b24

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 8, 2026