---
title: "RADIX.wiki MCP Server"
url: "https://radix.wiki/contents/resources/mcp-server"
version: "1.0.0"
updated: 2026-08-26
license: CC-BY-4.0
license_url: "https://creativecommons.org/licenses/by/4.0/"
---

# RADIX.wiki MCP Server

| RADIX.wiki MCP server |  |
| --- | --- |
| **Type** | Agent interface · reference |
| **Endpoint** | `https://radix.wiki/api/mcp` (POST only) |
| **Transport** | [MCP Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports), protocol version 2025-03-26 |
| **Server version** | 3.1.0 |
| **Registry name** | [wiki.radix/radix-wiki](https://registry.modelcontextprotocol.io) |
| **Tools** | 11 – seven read, two for the login handshake, two write |
| **Authentication** | None for reads. A [ROLA](/developers/frontend/03-rola-authentication) bearer token for `create_page` and `edit_page` |
| **Rate limit** | 60 requests per minute per IP, shared across all methods |
| **Measured** | 26 August 2026 |
| **Related** | [Radix for AI Agents](/contents/tech/core-concepts/radix-for-ai-agents) · [Radix Developer Resources](/developers/radix-developer-resources) · [Brand Assets](/contents/resources/brand-assets) |

An agent that wants to read this wiki does not have to scrape it. RADIX.wiki runs a [Model Context Protocol](https://modelcontextprotocol.io/specification/2025-03-26) server at `https://radix.wiki/api/mcp`, and it is the busiest thing on the site after the homepage: over the thirty days to 26 August 2026 the endpoint drew 219 of the wiki's 1,657 visitors, ahead of the [ecosystem directory](/ecosystem). This page is the reference for that server and for the flat files that sit beside it.

The server exposes the corpus as tools an assistant can call: search it, read a page, list a category, take the whole thing at once. Reads are open and never authenticate. Writes go through the same [ROLA](/developers/frontend/03-rola-authentication) wallet proof a human editor signs, so an agent holding a key gets exactly the permissions that key already had, and no others.

## Connecting

The transport is [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports): one URL, [JSON-RPC 2.0](https://www.jsonrpc.org/specification) over POST. A `GET` to the endpoint returns 405; a preflight `OPTIONS` returns 204 with `Access-Control-Allow-Origin: *`, so a browser-based client can reach it directly. There is no session to establish and no key to obtain.

Most clients take a block of JSON:

```json
{
  "mcpServers": {
    "radix-wiki": {
      "url": "https://radix.wiki/api/mcp"
    }
  }
}
```

The handshake is worth reading once, because the server answers it with its own instructions for how to use itself. `initialize` returns `serverInfo` of `radix-wiki` at version 3.1.0, a negotiated protocol version of `2025-03-26`, and an `instructions` string naming the usual sequence: `get_categories` to orient, `search_wiki` or `list_pages` to locate, `get_page` to read.

```shell
curl -s -X POST https://radix.wiki/api/mcp   -H 'Content-Type: application/json'   -H 'Accept: application/json, text/event-stream'   -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

The server also publishes two machine-readable descriptions of itself. A [server card](https://radix.wiki/api/mcp/server-card) at `/api/mcp/server-card` carries the name, version and remote endpoint in the schema the [official MCP registry](https://github.com/modelcontextprotocol/registry) reads, and the wiki is listed there as `wiki.radix/radix-wiki`, latest version 3.1.0, published 15 August 2026. An [agent card](https://radix.wiki/.well-known/agent-card.json) at `/.well-known/agent-card.json` describes the same capabilities as skills, for clients that discover agents rather than servers.

## The tools

Eleven tools, measured from a live `tools/list` call on 26 August 2026. Every listing tool returns a `tagPath` and a `slug`, and that pair is the address every read tool accepts.

| Tool | What it does | Auth |
| --- | --- | --- |
| `search_wiki` | Keyword search over titles and content. Returns titles, URLs, snippets and update dates. | None |
| `get_page` | Full text of one page, by `tagPath` and `slug`. | None |
| `list_pages` | Pages in a category, sorted by title or last update. | None |
| `get_categories` | The tag hierarchy with a page count per category. 369 pages at the time of writing. | None |
| `get_recent_changes` | Pages updated in the last _n_ days, capped at 30. | None |
| `get_full_corpus` | The entire wiki as one document, for bulk ingestion. | None |
| `get_ideas_board` | The [Ideas Pipeline](/ideas) kanban: community proposals and Radix DAO tasks by status column. | None |
| `get_challenge` | Step one of writing: a single-use ROLA challenge with a five-minute expiry. | None |
| `login` | Step two: exchange the signed proof for a seven-day bearer token. | None |
| `create_page` | Create a page. | Bearer |
| `edit_page` | Replace a page's block array; the version bump, diff and revision entry are handled server-side. | Bearer |

Two MCP resources sit alongside the tools: `radix-wiki://llms.txt`, the briefing document, and `radix-wiki://categories`, the hierarchy as JSON.

## Reading without MCP

Not every agent speaks the protocol, so the same corpus is published as flat files. Sizes below are as served on 26 August 2026.

| URL | Size | What it holds |
| --- | --- | --- |
| [/llms.txt](https://radix.wiki/llms.txt) | 15 KB | The [llms.txt](https://llmstxt.org) briefing: what Radix is, what the wiki covers, and where the other surfaces are. |
| [/llms-index.txt](https://radix.wiki/llms-index.txt) | 86 KB | Every page, grouped by section, newest first, each with a one-line summary. |
| [/llms-full.txt](https://radix.wiki/llms-full.txt) | 3.1 MB | The full text of the whole wiki in one file. |
| [/AGENTS.md](https://radix.wiki/AGENTS.md) | 9 KB | The agent API reference: the ROLA signing spec, REST equivalents and the content model. |
| [/openapi.json](https://radix.wiki/openapi.json) | 10 KB | OpenAPI description of the REST API behind all of it. |

Any page URL takes a `.md` suffix and returns that page as markdown, which is the cheapest way to read one article without a client. The flat files carry an `ETag` and answer a conditional request with 304, so a crawler that keeps the header pays nothing to check whether the corpus moved.

The wiki's [robots.txt](https://radix.wiki/robots.txt) disallows `/api/` for crawlers generally and then re-allows `/api/mcp`, `/api/wiki/` and the three `llms` files for the named assistant agents, so the surfaces meant for machines stay reachable while the edit and history routes do not.

## Writing through the protocol

An agent can contribute without leaving MCP. Call `get_challenge`, sign the returned ROLA message with an Ed25519 key held in a [Radix Wallet](/contents/tech/core-protocols/radix-wallet) account, call `login` with the proof, and send the resulting token as an `Authorization: Bearer` header on the POSTs that carry `create_page` and `edit_page`. [ROLA](https://docs.radixdlt.com/docs/rola-radix-off-ledger-auth) is Radix's off-ledger authentication scheme: the wallet proves control of an account by signing, and nothing is submitted to the ledger.

The write tools are a transport rather than a second implementation. Both forward to the REST endpoint that already owns the write path, carrying the caller's token, so the balance gate, the locked-page and author-only checks, block validation, the semantic version bump, the revision row and cache revalidation all run in one place. The default thresholds are a wallet balance of 10,000 XRD to create a page and 20,000 to edit one, and the balance is read rather than spent.

The practical consequence is that an agent is a contributor on the same terms as a person. It signs with a wallet, its edits carry an author and a revision message, and its work shows up in the same history any reader can open.

## External links

- [Model Context Protocol specification, 2025-03-26](https://modelcontextprotocol.io/specification/2025-03-26) – the version this server negotiates.
- [Official MCP registry](https://registry.modelcontextprotocol.io) – where `wiki.radix/radix-wiki` is listed.
- [AGENTS.md](https://radix.wiki/AGENTS.md) – the full agent API reference, including the ROLA signing spec.
- [llms.txt](https://llmstxt.org) – the convention the briefing file follows.
- [Awesome Radix MCP Servers](https://github.com/xstelea/awesome-radix-mcp-servers) – community index of MCP servers in the Radix ecosystem.
- [ROLA: Radix Off-Ledger Authentication](https://docs.radixdlt.com/docs/rola-radix-off-ledger-auth) – the wallet proof the write path requires.