Skip to main content

Model Context Protocol (MCP)

One-click integration guide for Claude Desktop, Cursor IDE, Windsurf, and Smithery.

On this page

Cursor users: start with Connect Cowpin to Cursor — one page, copy-paste config.

Cowpin provides an official Model Context Protocol (MCP) server that allows LLM assistants and coding agents to save, search, and recall research directly from your Cowpin memory vault.

Cowpin MCP server — Glama quality score

Open-source bridge: github.com/cowpin-ai/mcp-server · Directory listing and TDQS: Glama

⚡ Quick Setup

Install the bridge (works today)

curl -fsSL https://www.cowpin.com/install-mcp.sh | bash

That saves ~/.local/share/cowpin/mcp-bridge.mjs. Use it in MCP config with Node — no npm registry required.

Remote HTTP (no local process): point MCP at https://www.cowpin.com/api/agent/mcp with Authorization: Bearer cowpin_… — see Connect Cowpin to Cursor.

npm @cowpin/mcp-server: optional after publish; if npx returns 404, use the install script above.

1. Claude Desktop Setup

Add the Cowpin MCP server to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "cowpin": {
      "command": "node",
      "args": ["~/.local/share/cowpin/mcp-bridge.mjs"],
      "env": {
        "COWPIN_AGENT_API_KEY": "cowpin_REPLACE_ME"
      }
    }
  }
}

2. Cursor IDE Setup

In Cursor, open Settings → Features → MCP Servers or edit .cursor/mcp.json in your repository:

{
  "mcpServers": {
    "cowpin": {
      "command": "node",
      "args": ["~/.local/share/cowpin/mcp-bridge.mjs"],
      "env": {
        "COWPIN_AGENT_API_KEY": "cowpin_REPLACE_ME"
      }
    }
  }
}

Full walkthrough: Connect Cowpin to Cursor.

3. Smithery One-Click Install

If you use the Smithery CLI (requires @cowpin/mcp-server on npm when published):

npx -y @smithery/cli install @cowpin/mcp-server --client claude

Until npm publish, use the curl bridge + manual MCP config above.

🛠 Available Tools

ToolParametersDescription
cowpin_save_memoryurl (optional)
title (optional)
content (optional)
notes (optional)
tags (string)		Fetches a URL, cleans DOM bloat, extracts readable text, computes 1536-dim embeddings, and archives to Cowpin. Also accepts raw markdown notes.
cowpin_search_memoryquery (required)
limit (number, default: 5)
tags (string)		Performs hybrid Reciprocal Rank Fusion search across past research using full-text keywords and pgvector semantic similarity.
cowpin_get_balance(none)Checks current micro-credit balance and multi-chain deposit addresses.
cowpin_get_memory_pageid (string) or url (string)Retrieves the full archived text and snapshot of a previously saved memory.

💡 Example Prompt in Cursor or Claude

Once connected, simply talk to your assistant naturally:

"Save this article to my Cowpin memory: https://vitalik.eth.limo/general/2024/05/17/l2reorg.html with tags 'crypto' and 'l2'"

"Search my Cowpin vault for anything I saved about connection poolers."

Next steps