io.github.bch1212/pubrecords

Official10 tools

by bch1212 · Python

US public-records intelligence for AI agents — companies, SEC, courts, spending, licenses.

Accesses US public records data on companies, SEC filings, courts, and licenses.

Topics

ai-agentsanthropicclaudecompliancedue-diligencekybmcpmcp-servermodel-context-protocolopencorporatespublic-recordssec-edgar

Captured live from the server via tools/list.

mcp_search_companies

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).

Parameters (4)

namestringrequired
stateany
statusany
limitinteger

mcp_get_company_details

Fetch officers, agent, and filing history for a known company. Args: company_id: OpenCorporates company number. jurisdiction: Jurisdiction code (e.g. 'us_de', 'us_ca').

Parameters (2)

company_idstringrequired
jurisdictionstringrequired

mcp_search_sec_filings

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).

Parameters (4)

company_namestringrequired
form_typeany
date_fromany
limitinteger

mcp_get_sec_filing

Fetch metadata + index URL for one SEC filing by accession number. Args: accession_number: EDGAR accession number (e.g. '0001193125-21-000001').

Parameters (1)

accession_numberstringrequired

mcp_search_court_cases

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).

Parameters (4)

party_namestringrequired
courtany
date_fromany
limitinteger

mcp_lookup_federal_spending

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).

Parameters (4)

recipient_namestringrequired
agencyany
yearany
limitinteger

mcp_lookup_npi

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).

Parameters (4)

nameany
specialtyany
stateany
limitinteger

mcp_get_ucc_filings

UCC lien lookup. (Roadmap; returns not_implemented per state.) Args: debtor_name: Name of the debtor. state: 2-letter state code.

Parameters (2)

debtor_namestringrequired
statestringrequired

mcp_verify_entity

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.

Parameters (2)

namestringrequired
stateany

mcp_search_licenses

Search 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.

Parameters (3)

entity_namestringrequired
license_typeany
stateany

README.md7 KBView on GitHub

PubRecords MCP

Public-records intelligence for AI agents. Aggregate US business filings, SEC reports, federal court cases, federal spending awards, and professional licenses through a single MCP server. Built for due diligence, compliance, sales research, and background checks.

MCPize Listing Copy

PubRecords MCP turns the patchwork of US public-records APIs into a single, predictable tool surface for AI agents. One call cross-references a company across OpenCorporates, SEC EDGAR, USASpending.gov, CourtListener (RECAP), the NPI registry, and FCC license-view — and returns a normalized confidence score so your agent doesn't need to babysit the messy bits. Every endpoint is async, retries upstream 429s with exponential backoff, and never crashes — failures come back as structured {success: false, error: ...} envelopes that downstream tools can branch on cleanly.

Designed for due diligence and KYB workflows, compliance and adverse-media checks, sales prospecting, and background research. AI agents using PubRecords MCP can verify whether a counterparty actually exists, find their officers and registered agent, surface federal litigation history, see contract awards from Uncle Sam, and confirm professional licenses — all without juggling six different API keys, rate-limit headers, or response schemas. Cached 24 hours by default; most underlying records refresh daily at the source. Free tier (30 calls/day) for evaluation; Pro at $29/mo or $0.03/call for production traffic.

Pricing

Tier	Price	Limit
Free	$0	30 calls/day
Pro	$29/mo	Unlimited
Metered	$0.03/call	Pay-as-you-go

Default dev key (free tier): pubrecords-dev-key-001

Upgrade: https://mcpize.com/pubrecords-mcp

Tool Reference

Tool	Args	Returns
`search_companies`	`name`, `state?`, `status?`, `limit?`	OpenCorporates entities
`get_company_details`	`company_id`, `jurisdiction`	Officers, registered agent, filings
`search_sec_filings`	`company_name`, `form_type?`, `date_from?`, `limit?`	EDGAR filing list
`get_sec_filing`	`accession_number`	Filing metadata + index URL
`search_court_cases`	`party_name`, `court?`, `date_from?`, `limit?`	RECAP federal dockets
`lookup_federal_spending`	`recipient_name`, `agency?`, `year?`, `limit?`	USASpending awards
`lookup_npi`	`name?`, `specialty?`, `state?`, `limit?`	NPPES providers
`get_ucc_filings`	`debtor_name`, `state`	UCC liens (roadmap — see Data Gaps)
`verify_entity`	`name`, `state?`	Cross-source 0–100 confidence score
`search_licenses`	`entity_name`, `license_type?`, `state?`	NPI + FCC license union

Install in Claude

bash

claude mcp add --transport http pubrecords-mcp https://mcp-pubrecords-production.up.railway.app/mcp/

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:

code

X-API-Key: pubrecords-dev-key-001

Python SDK

A thin Python wrapper for non-MCP integrations is published on PyPI:

bash

pip install pubrecords

python

from pubrecords import PubRecords

client = PubRecords(api_key="pubrecords-dev-key-001")
print(client.health())
print(client.search_companies(name="Apple", state="CA"))

Source: pubrecords-sdk/. PyPI: https://pypi.org/project/pubrecords/.

REST surface (mirrors the MCP tools)

All MCP tools are also available over plain HTTP for non-MCP clients:

bash

curl -H "X-API-Key: pubrecords-dev-key-001" \
  "https://mcp-pubrecords-production.up.railway.app/tools/search_companies?name=Apple&state=CA"

Production URL: https://mcp-pubrecords-production.up.railway.app

text

GET  /health                          (no auth)
GET  /usage                           (X-API-Key)
GET  /tools/<tool_name>?...           (X-API-Key)
POST /mcp/                            (MCP streamable-http transport)

GET /usage returns your remaining daily quota. GET /health is unauthenticated.

Local development

bash

git clone https://github.com/bch1212/mcp-pubrecords.git
cd mcp-pubrecords
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --reload --port 8000

Run tests:

bash

pytest -v

Optional environment variables (see .env.example):

PUBRECORDS_SEC_USER_AGENT — SEC EDGAR requires an identifying UA. Set it in production.
OPENCORPORATES_TOKEN — raises the OpenCorporates anonymous cap of ~50/month.
COURTLISTENER_TOKEN — raises CourtListener's anonymous rate limit.
PUBRECORDS_CACHE_TTL — cache TTL in seconds (default 86400 = 24h).
PUBRECORDS_ADMIN_TOKEN — required to issue new keys at /admin/keys.

Data freshness

Responses are cached for 24 hours by default. Underlying source agencies update on different cadences:

Source	Refresh cadence
OpenCorporates	Daily / weekly (varies by jurisdiction)
SEC EDGAR	Real-time (filings appear ~minutes after submission)
USASpending.gov	Monthly (FY-end backfills)
CourtListener (RECAP)	Daily (depends on volunteer uploads)
NPPES NPI	Weekly
FCC License-View	Daily

For ultra-fresh queries, set PUBRECORDS_CACHE_TTL=300 (5 minutes) — note that this will multiply your upstream API costs.

Data Gaps & Source Limitations

These are honest caveats — the MCP returns structured not_implemented envelopes rather than fabricated data when a query falls outside coverage:

UCC filings — there is no uniform federal UCC API. Most state Secretary-of-State systems are HTML-only or require per-state credentials. get_ucc_filings returns {"error": "not_implemented"} until per-state adapters land (CA, DE, NY, TX are the priority backlog).
State professional licenses — covered for healthcare (NPI) and FCC. Other categories (bar, real estate, contractor, CPA) are state-by-state with no central API. search_licenses will say which sources matched.
OpenCorporates rate limits — anonymous traffic is capped at ~50 requests/month per IP. Set OPENCORPORATES_TOKEN for production. The 24h cache absorbs most of the burn.
SEC EDGAR full-text — search_sec_filings searches the body of filings, not just metadata, so query terms common across many filings can return wide result sets. Combine with form_type to narrow.
CourtListener coverage — federal only (PACER/RECAP). State court coverage is uneven and not guaranteed.
No PII / consumer-record sources — by design. PubRecords is for entity-level due diligence; consumer credit and identity data are deliberately out of scope.

License & Compliance

This MCP only proxies and caches public records that are already free to access from federal sources. Cached payloads are kept for 24 hours and can be flushed by deleting the SQLite DB. No PII is stored beyond what the underlying public-record agencies already publish.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "pubrecords": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-pubrecords-production.up.railway.app/mcp/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.