# AgentMash

> AgentMash is a freemium MCP server for knowledge and memory. Read-only search over bookmarks saved from X, LinkedIn, Reddit, YouTube and Instagram. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, Chrome extension, API, CLI
- **Website:** https://agentmash.ai
- **Repository:** https://github.com/ramyachinnadurai/agentmash-mcp
- **MCP Registry name:** ai.agentmash/agentmash
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

AgentMash keeps saves from several platforms in one library and lets an AI agent search it over MCP. A Chrome extension imports your saves when you click Sync, and nothing runs in the background. Facebook saves and GitHub stars can be imported too.

The six tools are all read-only, so an agent can look things up but never post or change anything. Answers come only from your own saves and link back to each one. Access uses an API key that starts with am_live_, shown once when created, and sent as a bearer header or a token query parameter for clients that cannot set headers. Revoking a key stops agents using it within about a minute.

The README has setup snippets for Claude Code, Claude Desktop, Cursor, Cline and Codex.

## Features

- **Unified library:** Combines saves from several platforms into one searchable library.
- **Read-only tools:** Six tools that only read, never post or edit.
- **Collections:** Lists your collections and fetches the saves inside one.
- **Recent saves:** Lists saves from the last few days.
- **API key access:** Keys are created and revoked in the Agents and API page.

## Good for

- Ask an assistant to find a thread you saved on X
- Pull saved articles into a research session
- Share a curated set of saves with a team's agents
- Check which platforms hold the most saves

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agentmash https://agentmash.ai/mcp
```

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

```sh
https://agentmash.ai/mcp
```

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

```json
{
  "mcpServers": {
    "agentmash": {
      "url": "https://agentmash.ai/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "agentmash": {
      "type": "http",
      "url": "https://agentmash.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentmash": {
      "serverUrl": "https://agentmash.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentmash": {
      "type": "http",
      "url": "https://agentmash.ai/mcp"
    }
  }
}
```

## Tools

- `search_saves`: Searches your saves, or lists the newest when no query is given.
- `get_save`: Gets one save in full, with text, stats, links, media and collections.
- `recent_saves`: Lists saves from the last few days.
- `list_sources`: Lists platforms in the library with save counts and last sync.
- `list_collections`: Lists collections with names, platform and save counts.
- `get_collection_saves`: Gets the saves inside one collection.

## FAQ

### Does it post for me?

No. AgentMash is read-only.

### What does the free plan include?

One platform, up to 25,000 saves, keyword search and 50 agent calls a month.

### How do I authenticate?

With an API key, not OAuth. Create it on the Agents and API page.

### Which clients are documented?

Claude Code, Claude Desktop, Cursor, Cline and Codex.

### Is there a lifetime option?

Yes, the site offers Pro for a one-time $99 to the first 50 buyers.

### Is AgentMash free?

AgentMash has a free plan, with paid plans for more usage or features.

### How do I add AgentMash to Claude Code?

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

### What are the best alternatives to AgentMash?

The closest alternatives to AgentMash 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/agentmash
