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