Skip to content
AGENTIC Data Mining
Docs

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.

mcp.config.json
{
  "mcpServers": {
    "agentic-data-mining": {
      "url": "https://mcp.agenticdatamining.ai/api/mcp",
      "headers": {
        "X-Api-Key": "${ADM_API_KEY}"
      }
    }
  }
}
  1. Sign up, pick a tier, and copy your sector keys from the account console.
  2. Export it as ADM_API_KEY in your agent's environment.
  3. 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.

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

limitnumber

Max 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 RefreshStatus
sec.filingsSEC Form 3/4/5 insider transactionsPUBLICDailyLive
contracts.awardsUSASpending federal contract awardsPUBLICHourlyLive
gov.assistanceFederal assistance awards (grants/loans/direct payments)PUBLICDailyLive
dla.dibbsDLA DIBBS micro-purchases (last-sold total award price by NSN + awardee CAGE)PUBLICDailyLive
dla.flisDLA FLIS / PUB LOG item catalog (identity + characteristics by NIIN, catalog reference price)PUBLICMonthlyLive
dla.prior_pricesDLA prior-award UNIT price by NSN + who won it (published prior unit — secondhand, republished inside a later solicitation)PUBLICDailyLive
risk.exclusionsFederal exclusions & debarment (SAM.gov + HHS-OIG LEIE)PUBLICDailyLive
ip.filingsUSPTO patents & assignmentsPUBLICDailyLive
trade.carriersFMCSA Motor Carrier CensusPUBLICMonthlyLive
env.water_useUSGS National Water UsePUBLIC5-yearLive
health.trialsClinicalTrials/FDAPUBLICDailyLive
fda.warning_lettersFDA warning lettersPUBLICDailyLive
sec.fundamentalsSEC company fundamentals (XBRL)PUBLICWeeklyLive
health.nih_grantsNIH research grantsPUBLICDailyLive
fda.approvalsFDA drug approvalsPUBLICDailyLive
gov.opportunitiesSAM.gov Contract OpportunitiesPUBLICDailyLive
health.providersNPPES healthcare providersPUBLICMonthlyLive
dla.nsn_suppliersKnown 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)PUBLICMonthlyLive
commerce.peptidesPeptide retail pricingAGGDailyLive

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
unauthorizedMissing or invalid keySurface to the operator; check ADM_API_KEY
sector_not_licensedTool outside the key's sectorsSuggest a tier change; list licensed sectors from the message
gated_pending_reviewGated dataset not yet clearedPoint the operator to the institutional request form
invalid_paramsParameter failed validationRead detail, fix, retry
window_too_largeDate window exceeds tier depthNarrow since/until or page by window
upstream_delaySource system lag; partial resultsUse returned records; note as_of in the answer