One config block away
Everything an agent needs to query the catalog: one MCP server, one API key, 19 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
Only limit is common to every tool; every other filter is dataset-specific (recipient name, NAICS code, NPI, ticker, and so on), served in that tool's own input schema at connection time. There is no free-text q or generic jurisdiction/since/until parameter — see the tool reference below, or the schema itself, for what each tool actually accepts.
limitnumberMax records per response (default 25, max 50 for nearly every tool; a couple of dataset-specific tools raise this ceiling in their own schema — check limit's description on connection)
Tool reference
19 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 | USASpending federal contract 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 |
| dla.flis | DLA FLIS / PUB LOG item catalog (identity + characteristics by NIIN, catalog reference price) | PUBLIC | Monthly | Live |
| dla.prior_prices | DLA prior-award UNIT price by NSN + who won it (published prior unit — secondhand, republished inside a later solicitation) | PUBLIC | Daily | Live |
| risk.exclusions | Federal exclusions & debarment (SAM.gov + HHS-OIG LEIE) | PUBLIC | Daily | Live |
| ip.filings | USPTO patents & assignments | 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.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.water_use | USGS National Water Use | PUBLIC | 5-year | Live |
| env.waterrights | Water rights | AGG | Monthly | Soon |
| legal.court | Court records | PUBLIC | Daily | Soon |
| 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 |
| dla.nsn_suppliers | Known suppliers for an NSN/FSC — DIBBS award history joined to SAM.gov entity registration by CAGE (prior awards only; no capability inference, no prices, no exclusion screen) | PUBLIC | Monthly | Live |
| 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 |