AgentMash MCP Server
README.md
# 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](https://agentmash.ai)
- 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](llms-install.md).
## Support
Email hello@agentmash.ai.