io.github.bch1212由 GitHub 账号 bch1212 发布v0.1.0更新于 Oct 26, 2026
US public-records intelligence for AI agents — companies, SEC, courts, spending, licenses.
面向美国公开记录调研的远程 MCP 服务器：公司注册信息、SEC 文件、联邦法院案件、联邦支出、执照与资助机会。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.bch1212%2Fpubrecords/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"pubrecords": {
"type": "http",
"url": "https://mcp-pubrecords-production.up.railway.app/mcp/",
"headers": {
"X-API-Key": "<YOUR_API_KEY>"
}
}
}
}One paid MCP server for US public records, federal grants, and federal contracts. Companies, SEC filings, court dockets, spending awards, licenses, Grants.gov opportunities, and SAM.gov contract notices share a single API key and a single bill.
This repository is the combined Halverson IQ Data server.
Not part of this server: business-intel and outdoor datasets (separate or retired), and web-page fetching (a different pipeline with its own fetchers and cache).
One customer key is checked on every tool. Free tier is 30 calls/day across the whole server. Pro is unlimited on the same key. Upgrade: https://mcpize.com/pubrecords-mcp
Keys are issued per user. Ask the operator for a key, or have them mint one with POST /admin/keys. Examples below use the placeholder YOUR_API_KEY.
focus_areas on the REST route is a comma-separated string. The MCP tool accepts a list.
Contract tools call SAM.gov only when SAM_API_KEY is set. If it is missing they return {"success": false, "error": "SAM_API_KEY is not configured"} and do not send a request.
Note the trailing slash on
/mcp/. Without it the gateway issues a 307 that drops the POST body, breaking the JSON-RPC handshake.
Then set the API key in your client:
A thin Python wrapper for non-MCP integrations lives in pubrecords-sdk/:
Every MCP tool is also available over plain HTTP. Send the same X-API-Key on each call.
Production URL: https://mcp-pubrecords-production.up.railway.app
GET /usage returns the remaining daily quota for that key. GET /health is unauthenticated.
POST /admin/keys and POST /billing/upgrade return 403 unless PUBRECORDS_ADMIN_TOKEN is set and the X-Admin-Token header matches it. There is no default admin token.
Promote that same key to the paid tier (this is the single billing switch):
Run tests:
Environment variables (see .env.example):
Responses are cached for 24 hours by default.
For fresher queries, set PUBRECORDS_CACHE_TTL=300 (5 minutes). That multiplies upstream traffic.
The server returns a structured error envelope instead of invented rows when a query is outside coverage.
get_ucc_filings returns {"error": "not_implemented"} until per-state adapters land.OPENCORPORATES_TOKEN for production.form_type.SAM_API_KEY is set in the environment. Apply at https://sam.gov. The key is not embedded in this repo.search_awards reads Award Notice rows from the opportunities API. Deeper recipient rollups stay on lookup_federal_spending (USASpending).match_opportunities is deterministic token overlap on title and agency. It does not call a model.This server proxies and caches public records that are already free to access from federal and public sources. Cached payloads are kept for 24 hours and can be flushed by deleting the SQLite file. Customer API keys and the admin token belong in the environment and the SQLite key store. Do not commit them.
来源：README.md，提交 fee4b77
Search US business entities by name (OpenCorporates). Args: name: Company or trade name to search for. state: 2-letter US state code (e.g. 'CA') to narrow jurisdiction. status: Filter by current status (e.g. 'active', 'dissolved'). limit: Max results (1-100, default 25).
name必填limitstatestatusFetch officers, agent, and filing history for a known company. Args: company_id: OpenCorporates company number. jurisdiction: Jurisdiction code (e.g. 'us_de', 'us_ca').
company_id必填jurisdiction必填Search SEC EDGAR full-text for filings. Args: company_name: Issuer name or keyword. form_type: Filing form (e.g. '10-K', '10-Q', '8-K'). date_from: Earliest filing date (YYYY-MM-DD). limit: Max results (1-100, default 25).
limitdate_fromform_typecompany_name必填Fetch metadata + index URL for one SEC filing by accession number. Args: accession_number: EDGAR accession number (e.g. '0001193125-21-000001').
accession_number必填Search federal court cases via CourtListener (RECAP). Args: party_name: Plaintiff or defendant name. court: CourtListener court id (e.g. 'nyed', 'txsd'). date_from: Earliest filing date (YYYY-MM-DD). limit: Max results (1-50, default 25).
courtlimitdate_fromparty_name必填Search USASpending.gov for awards (contracts + grants). Args: recipient_name: Award recipient name. agency: Awarding agency name (e.g. 'Department of Defense'). year: Fiscal year (e.g. 2024). limit: Max results (1-100, default 25).
yearlimitagencyrecipient_name必填Look up healthcare providers in the NPPES NPI registry. Args: name: Provider individual or organization name. specialty: Taxonomy description (e.g. 'Internal Medicine'). state: 2-letter state code. limit: Max results (1-200, default 25).
namelimitstatespecialtyUCC lien lookup. (Roadmap; returns not_implemented per state.) Args: debtor_name: Name of the debtor. state: 2-letter state code.
state必填debtor_name必填Cross-reference an entity across multiple sources and score confidence. Args: name: Entity name to verify. state: Optional 2-letter state code for jurisdiction filtering.
name必填stateSearch professional / business licenses (NPI + FCC, more sources roadmap). Args: entity_name: Licensee name. license_type: 'npi' | 'medical' | 'fcc' | 'radio' | 'all'. state: 2-letter state code.
stateentity_name必填license_type已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
claude mcp add --transport http halverson-iq-data https://mcp-pubrecords-production.up.railway.app/mcp/X-API-Key: YOUR_API_KEYpip install pubrecordsfrom pubrecords import PubRecords
client = PubRecords(api_key="YOUR_API_KEY")print(client.health())print(client.search_companies(name="Apple", state="CA"))print(client.search_grants(keyword="broadband"))curl -H "X-API-Key: YOUR_API_KEY" \ "https://mcp-pubrecords-production.up.railway.app/tools/search_companies?name=Apple&state=CA"
curl -H "X-API-Key: YOUR_API_KEY" \ "https://mcp-pubrecords-production.up.railway.app/tools/search_grants?keyword=broadband"GET /health (no auth)GET /usage (X-API-Key)GET /tools/<tool_name>?... (X-API-Key)POST /admin/keys (X-Admin-Token; fails closed)POST /billing/upgrade (X-Admin-Token; fails closed)POST /mcp/ (MCP streamable-http transport)curl -X POST https://mcp-pubrecords-production.up.railway.app/admin/keys \ -H "X-Admin-Token: $PUBRECORDS_ADMIN_TOKEN" \ -H "Content-Type: application/json" \ -d '{"key":"YOUR_API_KEY","tier":"free"}'curl -X POST https://mcp-pubrecords-production.up.railway.app/billing/upgrade \ -H "X-Admin-Token: $PUBRECORDS_ADMIN_TOKEN" \ -H "Content-Type: application/json" \ -d '{"key":"YOUR_API_KEY"}'git clone https://github.com/bch1212/mcp-pubrecords.gitcd mcp-pubrecordspython3 -m venv .venv && source .venv/bin/activatepip install -r requirements.txtcp .env.example .envuvicorn server:app --reload --port 8000pytest -v