MCP Server

Connect AI assistants to your Runa library using the Model Context Protocol. Save, search, and manage bookmarks from any MCP-compatible client.

Runa MCP Server connected in Claude Desktop

How it works

Runa exposes a remote MCP server with OAuth authentication. Add the server URL to your AI tool, authorize with your Runa account, and your assistant can interact with your bookmarks directly.

https://onruna.com/mcp

Setup

Claude Code

  1. Run the following command:
claude mcp add runa https://onruna.com/mcp

Claude Desktop

  1. Open Settings > MCP Servers > Add Server
  2. Enter the server URL:
https://onruna.com/mcp

Cursor

  1. Open Settings > MCP > Add new MCP server
  2. Set type to "sse" and enter the URL:
https://onruna.com/mcp

VS Code / Copilot

  1. Add to your settings.json:
{
  "mcp": {
    "servers": {
      "runa": {
        "type": "sse",
        "url": "https://onruna.com/mcp"
      }
    }
  }
}

ChatGPT

  1. Go to Settings > Connectors > Add connector
  2. Enter the server URL:
https://onruna.com/mcp

The first time you connect, you'll be prompted to authorize through your browser. After that, your AI assistant can use all the tools below.

Available tools

save_link

Save a URL as a bookmark. Automatically enriches metadata and triggers AI tagging.

list_links

List bookmarks filtered by status (inbox, archived, or trash).

search_links

Full-text search across bookmark titles and content.

get_link

Get a single bookmark by its ID.

update_link

Update a bookmark's title, description, status, or NSFW flag.

delete_link

Permanently delete a bookmark.

enrich_url

Fetch metadata for a URL without saving it. Preview before bookmarking.

Local server (advanced)

If you prefer a local stdio-based server (no OAuth, uses an API key), you can run it directly:

# Install
git clone https://github.com/imprakharshukla/Runa
cd Runa && bun install

# Configure
export RUNA_API_KEY="runa_sk_..."

# Add to your MCP client config
{
  "mcpServers": {
    "runa": {
      "command": "bun",
      "args": ["run", "packages/mcp/src/index.ts"],
      "env": { "RUNA_API_KEY": "runa_sk_..." }
    }
  }
}

Generate an API key from Settings → API Keys in your dashboard.