Getting Started

ra-mcp is available as a hosted MCP server — no installation needed. Connect it to your favourite AI client and start searching Swedish historical archives immediately.

Server URL:

https://riksarkivet-ra-mcp.hf.space/mcp

Connect to Claude.ai

Claude.ai supports adding MCP servers directly from the web interface.

1. Open claude.ai and go to a conversation
2. Click the :material-puzzle: Integrations icon (bottom-left of the chat input)
3. Select Add more integrations...
4. Choose Add custom MCP server
5. Enter:
   • Name: ra-mcp
   • URL: https://riksarkivet-ra-mcp.hf.space/mcp
6. Click Add

You should now see ra-mcp listed as a connected integration. Try asking:

"Search for trolldom in Swedish historical documents"

Connect to Claude Code (CLI)

Run a single command:

claude mcp add --transport http ra-mcp https://riksarkivet-ra-mcp.hf.space/mcp

Verify the connection:

claude mcp list

Then inside Claude Code, just ask naturally:

"Search for documents mentioning Stockholm from the 1600s"

Connect to Claude Desktop

Add this to your Claude Desktop configuration file:

=== "macOS / Linux"

Edit `~/.config/claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ra-mcp": {
      "type": "streamable-http",
      "url": "https://riksarkivet-ra-mcp.hf.space/mcp"
    }
  }
}
```

=== "Windows"

Edit `%APPDATA%\Claude\claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ra-mcp": {
      "type": "streamable-http",
      "url": "https://riksarkivet-ra-mcp.hf.space/mcp"
    }
  }
}
```

Restart Claude Desktop after saving the file.

Connect to VS Code / Cursor / Windsurf

Add to your project's .vscode/mcp.json (or global settings):

{
  "mcpServers": {
    "ra-mcp": {
      "type": "streamable-http",
      "url": "https://riksarkivet-ra-mcp.hf.space/mcp"
    }
  }
}

Connect to ChatGPT / Other MCP Clients

Any MCP-compatible client can connect using streamable HTTP: