AI Resources¶
Polkadot provides files to make documentation content available in a structure optimized for use with large language models (LLMs) and AI tools. These resources help build AI assistants, power code search, or enable custom tooling trained on Polkadot's documentation.
Connect via MCP¶
Use the Model Context Protocol (MCP) to connect your AI tools directly to Polkadot documentation.
-
Install via CLI
Client Command Claude Code CLI claude mcp add --transport http polkadot-docs https://docs-mcp.polkadot.comCodex CLI codex mcp add polkadot-docs --url https://docs-mcp.polkadot.com
Note
For Claude Code, add --scope user to make the MCP server available across all projects.
Access LLM Files¶
- Quick navigation: Use
llms.txtto give models a high-level map of the site. - Lightweight context: Use
site-index.jsonfor smaller context windows or when you only need targeted retrieval. - Full content: Use
llms-full.jsonlfor large-context models or preparing data for RAG pipelines. - Focused bundles: Use category files (e.g.,
basics.md,reference.md) to limit content to a specific theme or task for more focused responses.
These AI-ready files do not include any persona or system prompts. They are purely informational and can be used without conflicting with your existing agent or tool prompting.
Full Site Files¶
| File | Description | Token Estimate | Actions |
|---|---|---|---|
llms.txt | Markdown URL index for documentation pages, links to essential repos, and additional resources in the llms.txt standard format. | 22,069 | |
site-index.json | Lightweight site index of JSON objects (one per page) with metadata and content previews. | 108,681 | |
llms-full.jsonl | Full content of documentation site enhanced with metadata. | 793,970 |
Note
The llms-full.jsonl file may exceed the input limits of some language models due to its size. If you encounter limitations, consider using the smaller site-index.json or category bundle files instead.
Category Files¶
Apps¶
Building and shipping Products on the Polkadot platform, from identity setup and local development through to deployment and discovery.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
apps.md | Full bundle — complete page content for all tagged pages. | 169,115 | |
apps-light.md | Lightweight index — titles, URLs, previews, and section headings. | 9,589 |
Basics¶
Polkadot overview, core concepts, and getting started guides for new developers.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
basics.md | Full bundle — complete page content for all tagged pages. | 63,784 | |
basics-light.md | Lightweight index — titles, URLs, previews, and section headings. | 5,393 |
Smart Contracts¶
Developing and deploying smart contracts on Polkadot Hub using Solidity, EVM, PolkaVM, and tools like Hardhat and Foundry.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
smart-contracts.md | Full bundle — complete page content for all tagged pages. | 221,051 | |
smart-contracts-light.md | Lightweight index — titles, URLs, previews, and section headings. | 7,223 |
Parachains¶
Building and deploying parachains with the Polkadot SDK, including runtime development, pallets, and coretime.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
parachains.md | Full bundle — complete page content for all tagged pages. | 215,461 | |
parachains-light.md | Lightweight index — titles, URLs, previews, and section headings. | 6,590 |
Chain Interactions¶
How to query on-chain data, send transactions, communicate across chains, and manage tokens and accounts on Polkadot-based chains.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
chain-interactions.md | Full bundle — complete page content for all tagged pages. | 181,728 | |
chain-interactions-light.md | Lightweight index — titles, URLs, previews, and section headings. | 1,773 |
Interoperability¶
Cross-chain communication via XCM, asset transfers, HRMP channels, and bridging to external networks.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
interoperability.md | Full bundle — complete page content for all tagged pages. | 163,465 | |
interoperability-light.md | Lightweight index — titles, URLs, previews, and section headings. | 1,954 |
Infrastructure¶
Running validators, collators, and RPC nodes, plus staking mechanics and key management.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
infrastructure.md | Full bundle — complete page content for all tagged pages. | 188,112 | |
infrastructure-light.md | Lightweight index — titles, URLs, previews, and section headings. | 3,118 |
Polkadot Protocol¶
Protocol internals covering consensus, coretime, block production, cryptography, and chain architecture.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
polkadot-protocol.md | Full bundle — complete page content for all tagged pages. | 165,662 | |
polkadot-protocol-light.md | Lightweight index — titles, URLs, previews, and section headings. | 5,145 |
Tooling¶
Developer SDKs and tools including PAPI, Polkadot.js, subxt, light clients, and testing frameworks.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
tooling.md | Full bundle — complete page content for all tagged pages. | 274,553 | |
tooling-light.md | Lightweight index — titles, URLs, previews, and section headings. | 8,406 |
Reference¶
Glossary, governance structures, origin tracks, and technical specifications.
| File | Description | Token Estimate | Actions |
|---|---|---|---|
reference.md | Full bundle — complete page content for all tagged pages. | 76,455 | |
reference-light.md | Lightweight index — titles, URLs, previews, and section headings. | 9,179 |
| Created: August 15, 2025