# Mash Prime

> Mash Prime is a free MCP server for knowledge and memory. Read-only access to Mash Prime's essays and build notes on agentic systems. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://mashprime.dev/developers/
- **MCP Registry name:** dev.mashprime/mashprime
- **Categories:** knowledge and memory, news and media
- **Listing updated:** 2026-11-15

## About

Five tools cover orientation, listing, reading, search and related posts. `read_post` returns a post's full markdown, `search_posts` ranks results with BM25 over a passage index and returns a relevant snippet, and `related_posts` follows similarity of text embeddings to move from one post to the next.

The same site also offers a versioned read-only JSON API with an OpenAPI 3.1 spec, errors in RFC 9457 format and a limit of 60 requests per 60 seconds per IP, shared in kind with the MCP endpoint. Pages also register WebMCP tools when the browser supports it, including ones that navigate, scroll to a section or switch theme.

It is a single publisher's reading list, not a general knowledge source, useful when an assistant needs to cite or summarise that site's posts.

## Features

- **Post listing:** `list_posts` returns slugs, titles, descriptions and dates, newest first.
- **Full-text reading:** `read_post` returns a post's complete markdown.
- **Ranked search:** `search_posts` ranks matches best first and returns a snippet.
- **Related posts:** `related_posts` finds posts closest in meaning using embeddings.
- **No authentication:** The API and MCP server are public and read-only with open CORS.
- **WebMCP tools:** Pages expose in-browser tools where document.modelContext exists.

## Good for

- Have an assistant summarise a post on agent memory
- Search the blog for a topic and quote the passage
- Follow a thread of related posts
- Load the OpenAPI spec into a tool-calling layer

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mashprime https://mashprime.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mashprime.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mashprime": {
      "url": "https://mashprime.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mashprime": {
      "type": "http",
      "url": "https://mashprime.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mashprime": {
      "serverUrl": "https://mashprime.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mashprime": {
      "type": "http",
      "url": "https://mashprime.dev/mcp"
    }
  }
}
```

## Tools

- `site_info`: Orientation on who Mash Prime is, what the site covers and its pages, as markdown.
- `list_posts`: Lists published blog posts with slug, title, description and date, newest first.
- `read_post`: Reads the full markdown text of one blog post by slug.
- `search_posts`: Searches posts across titles, descriptions and full text, best match first, with snippets.
- `related_posts`: Finds posts closest in meaning to a given post by embedding similarity.

## FAQ

### Do I need an API key?

No. The API and MCP server need no keys or accounts.

### What are the rate limits?

60 requests per 60 seconds per client IP, with the MCP endpoint counted separately.

### Can it modify anything?

No. It is read-only.

### Which tools does it expose?

site_info, list_posts, read_post, search_posts and related_posts.

### Is Mash Prime free?

Yes. Mash Prime is free to use.

### How do I add Mash Prime to Claude Code?

Run this command in your terminal: claude mcp add --transport http mashprime https://mashprime.dev/mcp

### What are the best alternatives to Mash Prime?

The closest alternatives to Mash Prime are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mash-prime
