One config block away
Everything an agent needs to query the catalog: one MCP server, one API key, 15 live dataset tools. REST delivery is available on Desk and Institutional tiers at the same endpoint. More datasets roll out over time — request a dataset to prioritize one.
Quickstart
Paste this into your agent's MCP configuration and set your key. On connection, the server advertises every dataset tool your subscription carries.
{
"mcpServers": {
"agentic-data-mining": {
"url": "https://mcp.agenticdatamining.ai/api/mcp",
"headers": {
"X-Api-Key": "${ADM_API_KEY}"
}
}
}
}
- Sign up, pick a tier, and copy your sector keys from the account console.
- Export it as
ADM_API_KEYin your agent's environment. - Restart the session. Ask a question; the agent picks the tool.
Header-less clients
Some connectors — ChatGPT and Codex custom connectors, Claude custom connectors — have no API-key field, only OAuth or No-Auth. For these, connect with No-Auth to a capability URL that carries the credential in the path:
https://mcp.agenticdatamining.ai/api/mcp/k/{admc_token}
Mint a capability token from an existing sector key, then paste the returned URL as a No-Auth MCP server. Revoke it any time — the URL stops working immediately.
# mint
curl -sS -X POST https://mcp.agenticdatamining.ai/api/mcp/tokens \
-H "X-Api-Key: adm_live_…"
# revoke
curl -sS -X POST https://mcp.agenticdatamining.ai/api/mcp/tokens/{id}/revoke \
-H "X-Api-Key: adm_live_…"
Treat the capability URL like a password — anyone holding it can query your sector until it's revoked.
Authentication
Every request carries an API key. Each sector of data has its own key — a leaked key never exposes more than one sector, and you can rotate any one from the account console without touching the others; old keys expire after a 24-hour grace window. Developer accounts hold keys for the two sectors chosen at signup; Desk and Institutional hold all seven.
X-Api-Key: adm_live_9f27c1…
Keys never appear in query strings, and we log key ID — not key material — in access logs.
Shared parameters
Every dataset tool accepts these; each tool adds dataset-specific filters, served in the tool's input schema at connection time.
qstringFree-text search over record fields
jurisdictionstringState, county, agency, or venue code
since / untilISO dateFiling or event date window
limitnumberMax records per response (default 25, max 500)
Tool reference
15 tools, one per live dataset. Full schemas, coverage notes, and sample records are on each dataset page in the catalog. More ship through 2026 — request a dataset to prioritize one.
| Tool | Dataset | Tier | Refresh | Status |
|---|---|---|---|---|
| sec.filings | SEC Form 3/4/5 insider transactions | PUBLIC | Daily | Live |
| congress.trades | STOCK Act trades | PUBLIC | Daily | Soon |
| contracts.awards | SAM.gov awards | PUBLIC | Hourly | Live |
| gov.assistance | Federal assistance awards (grants/loans/direct payments) | PUBLIC | Daily | Live |
| dla.dibbs | DLA DIBBS micro-purchases (last-sold total award price by NSN + awardee CAGE) | PUBLIC | Daily | Live |
| risk.exclusions | Federal exclusions & debarment (SAM.gov + HHS-OIG LEIE) | PUBLIC | Daily | Soon |
| ip.filings | USPTO patents/TM | PUBLIC | Daily | Live |
| customs.bol | Bill of lading | AGG | Daily | Soon |
| maritime.ais | Port/vessel AIS | AGG | Near-real-time | Soon |
| freight.rates | Freight rates | GATED | Daily | Soon |
| trade.carriers | FMCSA Motor Carrier Census | PUBLIC | Monthly | Live |
| permits.search | Building permits | PUBLIC | Hourly | Soon |
| permits.datacenter | Data center permits | AGG | Daily | Soon |
| property.assessor | Assessor/tax lien | PUBLIC | Weekly | Soon |
| permits.evcharging | EV charging permits | AGG | Daily | Soon |
| permits.zoning | Zoning/variances | PUBLIC | Weekly | Soon |
| property.hoa | HOA docs | AGG | Weekly | Soon |
| energy.queues | Interconnection queues | PUBLIC | Weekly | Soon |
| energy.leases | Oil & gas leases | PUBLIC | Weekly | Soon |
| env.permits | EPA permits | PUBLIC | Weekly | Soon |
| env.waterrights | Water rights | AGG | Monthly | Soon |
| legal.court | Court records | PUBLIC | Daily | Soon |
| corp.formations | Business Formations (Colorado) | PUBLIC | Daily | Live |
| labor.postings | Job postings/wages | GATED | Daily | Soon |
| health.trials | ClinicalTrials/FDA | PUBLIC | Daily | Live |
| fda.warning_letters | FDA warning letters | PUBLIC | Daily | Live |
| sec.fundamentals | SEC company fundamentals (XBRL) | PUBLIC | Weekly | Live |
| health.nih_grants | NIH research grants | PUBLIC | Daily | Live |
| fda.approvals | FDA drug approvals | PUBLIC | Daily | Live |
| gov.opportunities | SAM.gov Contract Opportunities | PUBLIC | Daily | Live |
| health.providers | NPPES healthcare providers | PUBLIC | Monthly | Live |
| corp.osha | OSHA Enforcement | PUBLIC | Daily | Soon |
| commerce.peptides | Peptide retail pricing | AGG | Daily | Live |
| ag.cattle | Feeder cattle pricing | GATED | Daily | Soon |
| ag.auctions | Livestock auctions | AGG | Daily | Soon |
| ag.pedigree | Horse pedigree | GATED | Weekly | Soon |
| ag.registry | Wagyu/Angus registry | GATED | Weekly | Soon |
Errors
Errors come back as structured tool results, so agents can recover without human help. There is no rate-limit error tied to billing — flat means flat. If a tool is failing repeatedly, check the service status page before writing in.
| Code | Meaning | Agent should |
|---|---|---|
| unauthorized | Missing or invalid key | Surface to the operator; check ADM_API_KEY |
| sector_not_licensed | Tool outside the key's sectors | Suggest a tier change; list licensed sectors from the message |
| gated_pending_review | Gated dataset not yet cleared | Point the operator to the institutional request form |
| invalid_params | Parameter failed validation | Read detail, fix, retry |
| window_too_large | Date window exceeds tier depth | Narrow since/until or page by window |
| upstream_delay | Source system lag; partial results | Use returned records; note as_of in the answer |