# Dimensions

> Dimensions is a research data platform from Digital Science covering 430M+ interconnected
> research records — publications, grants, patents, clinical trials, datasets, policy documents,
> researchers and organizations. The Dimensions Analytics API exposes that graph through the
> Dimensions Search Language (DSL): a subscription-only, read-only HTTP surface with exactly two
> endpoints — one to exchange an API key for a ~2 hour JWT, one to POST a DSL query. Digital
> Science also publishes a first-party MCP server that projects the DSL as 27 agent tools.

Provenance: this file was GENERATED by API Evangelist on 2026-09-06 from the Dimensions
public documentation and this repository's artifacts. Dimensions does not publish an llms.txt
at https://docs.dimensions.ai/llms.txt or https://www.dimensions.ai/llms.txt (both 404 on
2026-09-06). It is not an official Dimensions document.

Key facts an agent should know before calling:
- Access is by institutional subscription only. There is no free tier, no self-serve signup,
  and no published pricing. Free access exists for eligible scientometric research projects.
- 30 requests per IP address per minute, edge-enforced, not modifiable, and NOT signalled:
  the API returns neither Retry-After nor X-RateLimit-* headers. Self-throttle.
- Max 1,000 rows per call; max 50,000 records per search via limit/skip; max 1,000 facet buckets.
- The auth header keyword is `JWT`, not `Bearer`.
- Bulk extraction, local mirroring of Dimensions data, and use for model training are
  prohibited by the Reasonable Use policy.

## API

- [API Access (auth, endpoints, clients)](https://docs.dimensions.ai/dsl/api.html): the two-step
  token exchange, endpoint table, and copy-paste examples in Python, curl+jq, PowerShell and Postman.
- [Query Syntax (DSL language reference)](https://docs.dimensions.ai/dsl/language.html)
- [Functions Syntax](https://docs.dimensions.ai/dsl/functions.html): classify, extract_affiliations,
  extract_grants, similar_documents, concepts.
- [Data Sources](https://docs.dimensions.ai/dsl/data-sources.html): every source, field, fieldset,
  facet and indicator.
- [Example Queries and Results](https://docs.dimensions.ai/dsl/examples.html)
- [Getting Started Checklist](https://docs.dimensions.ai/dsl/getting-started.html)
- [Reasonable Use and Technical Limits](https://docs.dimensions.ai/dsl/usagepolicy.html)
- [Release Notes and Deprecations](https://docs.dimensions.ai/dsl/releasenotes.html)
- [FAQ, including the API error-code table](https://docs.dimensions.ai/dsl/faq.html)

## Agents and MCP

- [Dimensions Analytics MCP documentation](https://docs.dimensions.ai/dsl/mcp.html)
- [Dimensions Analytics MCP source (MIT)](https://github.com/digital-science/dimensions-analytics-mcp)
- [Tool reference — 27 tools](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/USAGE.md#all-mcp-tools)
- [MCP reference — env vars, rate limits, schema cache](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/REFERENCE.md)
- Install (local stdio, Node 20+): `npx -y @digital-science-dsl/dimensions-analytics-mcp`
  with `DIMENSIONS_API_KEY` set. A hosted URL+token option is announced as coming soon and is
  NOT yet available.
- A separate OAuth-gated remote MCP endpoint runs on the marketing site at
  https://www.dimensions.ai/wp-json/mcp/mcp-oauth-server (RFC 9728 metadata at
  https://www.dimensions.ai/.well-known/oauth-protected-resource, scope `mcp`, PKCE S256).

## Clients

- [dimcli — official Python client and DSL console (PyPI, MIT)](https://pypi.org/project/dimcli/)
- [dimcli source](https://github.com/digital-science/dimcli)
- [Dimensions API Lab — Jupyter notebooks](https://api-lab.dimensions.ai/)
- [Google Sheets Connector](https://docs.dimensions.ai/dsl/gsheets.html)
- [Excel Add-in](https://docs.dimensions.ai/dsl/excel.html)

## Operations

- [Status page](https://status.dimensions.ai/)
- [Help Center](https://help.dimensions.ai/)
- API support: supportapi@dimensions.ai
- [Request a demo or quote](https://www.dimensions.ai/request-a-demo-or-quote/)
- [Free access for scientometric research](https://www.dimensions.ai/scientometric-research/)

## Legal

- [Privacy Policy](https://www.dimensions.ai/privacy/)
- [Website terms of use](https://www.dimensions.ai/website-terms/)

## Optional

- [Dimensions website](https://www.dimensions.ai/)
- [Dimensions API product page](https://www.dimensions.ai/products/all-products/dimensions-api/)
- [Digital Science MCP overview](https://www.digital-science.com/model-context-protocol-mcp/)
- [Dimensions blog](https://www.dimensions.ai/blog/)