Skip to main content

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

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)

Source distribution for pubrecords 0.1.0
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)

Table of built distributions (wheels) for pubrecords 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page