Public documentation

Structured data, built to be called by agents.

Agent Datasets exposes one bounded, self-describing tool surface over MCP, with a REST mirror for applications that prefer HTTP endpoints.

Connect over MCP

Add the hosted server to your client.

Create a key in the dashboard, then add the streamable-HTTP endpoint and the key header to Claude Desktop, Claude Code, Cursor, or another MCP client.

[ .JSON ]mcp.servers

1{
"mcpServers": {
  "agent-datasets": {
    "type": "http",
    "url": "https://api.agentdatasets.com/mcp",
    "headers": {
      "X-API-KEY": "adk_..."
    }
  }
}
11}

Authentication

API keys today; OAuth next.

Hosted MCP and REST requests currently authenticate with an X-API-KEY header. Use a public-surface key whenever the credential may leave your organisation; public keys enforce the redistribution gate. The hosted MCP endpoint already advertises OAuth 2.1 discovery metadata, but self-serve OAuth onboarding is not open yet — use an API key.

Keys are secrets. Keep them out of source control and manage them from the dashboard.

REST quickstart

The same service, over HTTP.

Request a bounded income-statement result for Apple with a public API key:

[ SH ]GET /v1/stocks/income-statements

1curl --fail --silent --show-error \
2  --header "X-API-KEY: adk_..." \
3  "https://api.agentdatasets.com/v1/stocks/income-statements?ticker=AAPL"

Successful REST responses use the same top-level envelope: payload rows in data, request and provenance details in meta, and cursor state in pagination.

[ .JSON ]response envelope

1{
"data": {
  "ticker": "AAPL",
  "company_name": "Apple Inc.",
  "statements": [ ... ]
},
"meta": {
  "source": "sec_edgar_companyfacts",
  "as_of": "2026-07-12T18:05:22Z"
},
"pagination": {
  "limit": 1,
  "has_more": true,
  "next_cursor": "eyJ2IjoxLCJrIjpb..."
}
16}

Reference

Structured data, built to be called by agents.

Add the hosted server to your client.

API keys today; OAuth next.

The same service, over HTTP.

Know the surface and the data behind it.

Tool catalog

Conventions

Attribution

Terms