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

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

Every dataset tool accepts these; each tool adds dataset-specific filters, served in the tool's input schema at connection time.

qstring

Free-text search over record fields

jurisdictionstring

State, county, agency, or venue code

since / untilISO date

Filing or event date window

limitnumber

Max 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 RefreshStatus
sec.filingsSEC Form 3/4/5 insider transactionsPUBLICDailyLive
contracts.awardsSAM.gov 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
ip.filingsUSPTO patents/TMPUBLICDailyLive
trade.carriersFMCSA Motor Carrier CensusPUBLICMonthlyLive
corp.formationsBusiness Formations (Colorado)PUBLICDailyLive
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
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