MCP Server

The Real Threads MCP server exposes the site's project knowledge base, primer library, and content catalog to any Model Context Protocol compatible client. It is read-only and requires no authentication.

Endpoint

https://realthreads.io/api/context/mcp

The route is transport-agnostic — it supports both Streamable HTTP (default) and SSE via the same base path. Most MCP clients will connect using Streamable HTTP automatically.

Tools

listProjects

List all projects on the site with metadata — slug, title, date, category, themes, description, URL, and primer availability.

Parameters: None

getProjectPrimer

Retrieve the full primer markdown for a specific project. Returns the primer content as text, or an error with available slugs if the project is not found.

Parameters: slug (string, required) — the project slug, e.g. "energy", "vector-atlas"

searchCatalog

Search the site-wide content catalog for artifacts — blog posts, datasets, interactive experiences, diagrams, primers, and more. At least one parameter must be provided.

Parameters:

• query (string, optional) — keyword to search titles, descriptions, and IDs
• project (string, optional) — filter by project slug
• type (string, optional) — filter by artifact type: image, dataset, html-embed, interactive, blog-post, cms-collection, mdx-content, diagram, document, primer

getArtifact

Retrieve full metadata for a single catalog artifact by its unique ID.

Parameters: id (string, required) — the artifact ID, e.g. "interactive:energy:energy1_intro"

Resources

siteOverview

URI: context://realthreads.io/overview

A high-level overview of realthreads.io — what the site is, how it's organised, and what kinds of content it contains. Suitable as initial context for any agent consuming the service.

primerIndex

URI: context://realthreads.io/primers

An index of all available project primers with slug, title, and tier classification. Agents can use this to discover which primers to request via getProjectPrimer.

Client Configuration

Add the following to your mcp.json (VS Code, Cursor, or any MCP-compatible client):

{
  "servers": {
    "realthreads": {
      "url": "https://realthreads.io/api/context/mcp"
    }
  }
}

Once connected, use listProjects to discover available projects, getProjectPrimer to fetch detailed context for any project, and searchCatalog to explore the full content catalog.