pubrecords
Python client for the PubRecords MCP — public-records intelligence for AI agents (US business filings, SEC EDGAR, federal courts, federal spending, healthcare/FCC licenses).
For agentic use, install the MCP directly into Claude:
claude mcp add --transport http pubrecords-mcp https://mcp-pubrecords-production.up.railway.app/mcp/
(Note the trailing slash on /mcp/.)
This Python SDK is for non-MCP code that wants the same data shape over plain HTTP.
Install
pip install pubrecords
Quickstart
from pubrecords import PubRecords
with PubRecords(api_key="pubrecords-dev-key-001") as client:
print(client.health())
print(client.search_companies(name="Apple", state="CA"))
print(client.verify_entity(name="Boeing"))
Async variant:
import asyncio
from pubrecords import PubRecordsAsync
async def main():
async with PubRecordsAsync() as client:
print(await client.search_sec_filings("Apple", form_type="10-K"))
asyncio.run(main())
Tools
| Method | Description |
|---|---|
search_companies(name, state, status, limit) |
OpenCorporates entity search |
get_company_details(company_id, jurisdiction) |
Officers, agent, filings |
search_sec_filings(company_name, form_type, date_from, limit) |
SEC EDGAR full-text |
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) |
verify_entity(name, state) |
Cross-source confidence score |
search_licenses(entity_name, license_type, state) |
NPI + FCC license union |
Pricing
- Free: 30 calls/day with the seeded dev key (
pubrecords-dev-key-001). - Pro: $29/mo unlimited at https://mcpize.com/pubrecords-mcp.
- Metered: $0.03/call.
Repo
https://github.com/bch1212/mcp-pubrecords
License
MIT
Metadata
Release files for pubrecords 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pubrecords-0.1.0.tar.gz | 4.3 kB | Without provenance | Details for pubrecords-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pubrecords-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for pubrecords-0.1.0-py3-none-any.whl |
Total release size: 9.6 kB
Release files / pubrecords-0.1.0.tar.gz
| Download URL | pubrecords-0.1.0.tar.gz |
|---|---|
| Size | 4.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f17e1d41cece0896fe9802ea3ee11e7edb50dab92d637a7ff63501858400bb03
|
|
BLAKE2b-256 checksum How to use checksums |
54c1a4bc2f7c74b0b74139235d7937b11e4d410abbbda7b40374cd7d8ac6cc24
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Release files / pubrecords-0.1.0-py3-none-any.whl
| Download URL | pubrecords-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a2be8568c966ee949cc95129c37e42f0440a429fa0e4f90f7c978fbf424196c
|
|
BLAKE2b-256 checksum How to use checksums |
51ba998dca3e442f09c41c65ea72dcc7d8aba0d2f8dc287863bd68978d5d28d8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Security for pubrecords 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.