agentmash-mcp

AgentMash MCP server

All your bookmarks in one library. Share them with your AI agents.

This repo documents the hosted AgentMash MCP server: how to connect your AI agent to your AgentMash library.

What AgentMash does

• The AgentMash Chrome extension imports your saves from X, LinkedIn, Instagram and more when you click Sync. Nothing runs in the background.
• Everything lands in one library.
• Your AI agents read that library over MCP, with read-only tools.

Server

• URL: https://agentmash.ai/mcp
• Transport: Streamable HTTP

Authentication

AgentMash uses an API key, not OAuth.

1. In AgentMash, open the Agents & API page and click Create API key.
2. Copy the key right away. It starts with am_live_ and is shown only once.
3. Send it as a header:

Authorization: Bearer am_live_YOUR_KEY

For clients that cannot set headers, append ?token=am_live_YOUR_KEY to the URL instead.

Setup

Replace am_live_YOUR_KEY with your own key in each snippet.

Claude Code

claude mcp add --transport http agentmash https://agentmash.ai/mcp --header "Authorization: Bearer am_live_YOUR_KEY"

Claude Desktop

Claude Desktop connects through the mcp-remote bridge, so you need Node (with npx) installed. Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "agentmash": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agentmash.ai/mcp",
        "--header",
        "Authorization: Bearer am_live_YOUR_KEY"
      ]
    }
  }
}

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "agentmash": {
      "url": "https://agentmash.ai/mcp",
      "headers": {
        "Authorization": "Bearer am_live_YOUR_KEY"
      }
    }
  }
}

Cline

In Cline, open MCP Servers, then Configure, then Configure MCP Servers, and add this to cline_mcp_settings.json. Set "type": "streamableHttp": without it Cline falls back to the legacy SSE transport and will not connect.

{
  "mcpServers": {
    "agentmash": {
      "type": "streamableHttp",
      "url": "https://agentmash.ai/mcp",
      "headers": {
        "Authorization": "Bearer am_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Or with the Cline CLI:

cline mcp add agentmash https://agentmash.ai/mcp --transport http --header "Authorization: Bearer am_live_YOUR_KEY" --yes

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.agentmash]
url = "https://agentmash.ai/mcp"
bearer_token_env_var = "AGENTMASH_API_KEY"

Then set the key in your shell before starting Codex: export AGENTMASH_API_KEY=am_live_YOUR_KEY. Codex reads the bearer token from that environment variable.

Tools

All six tools are read-only.

Tool	What it does
search_saves	Searches your saves. Leave the query out to list your newest saves first.
get_save	Gets one save in full: text, stats, links, media and collections.
recent_saves	Lists saves from the last few days.
list_sources	Lists the platforms in your library, with saves per platform and last sync.
list_collections	Lists your collections with their names, platform and number of saves.
get_collection_saves	Gets the saves inside one collection.

Revoke a key

Open the Agents & API page in AgentMash and click Revoke on the key. Agents using that key stop working within about a minute.

Links

• AgentMash
• MCP setup guide: https://agentmash.ai/mcp-setup

About this repo

The AgentMash app source code is not in this repo. This repo only documents the hosted MCP server.

For AI coding agents, see llms-install.md.

Support

Email hello@agentmash.ai.