AgentMash

السجل الرسمي البحث والويب

All your bookmarks in one library. Share them with your AI agents. Read-only search over your saves.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http agentmash 'https://agentmash.ai/mcp' --header 'Authorization: <Your AgentMash API key from the Agents & API page, sent as: Bearer am_live_YOUR_KEY>'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "agentmash": {
            "type": "http",
            "url": "https://agentmash.ai/mcp",
            "headers": {
                "Authorization": "<Your AgentMash API key from the Agents & API page, sent as: Bearer am_live_YOUR_KEY>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. AgentMash MCP server
  2. What AgentMash does
  3. Server
  4. Authentication
  5. Setup
  6. Tools
  7. Revoke a key
  8. Links
  9. About this repo
  10. Support

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.

ToolWhat it does
search_savesSearches your saves. Leave the query out to list your newest saves first.
get_saveGets one save in full: text, stats, links, media and collections.
recent_savesLists saves from the last few days.
list_sourcesLists the platforms in your library, with saves per platform and last sync.
list_collectionsLists your collections with their names, platform and number of saves.
get_collection_savesGets 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.

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.

الأسئلة الشائعة

ما هو AgentMash؟

All your bookmarks in one library. Share them with your AI agents. Read-only search over your saves.

كيف أثبّت AgentMash؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http agentmash 'https://agentmash.ai/mcp' --header 'Authorization: <Your AgentMash API key from the Agents & API page, sent as: Bearer am_live_YOUR_KEY>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج AgentMash إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل AgentMash مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون AgentMash؟

ينشره RamyaChinnadurai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.