Model Context Protocol (MCP)

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.

⚡ Quick Setup

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": "npx",
      "args": ["-y", "@cowpin/mcp-server"],
      "env": {
        "COWPIN_AGENT_API_KEY": "cw_agent_your_api_key_here",
        "COWPIN_API_URL": "https://www.cowpin.com"
      }
    }
  }
}

2. Cursor IDE Setup

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

{
  "mcpServers": {
    "cowpin": {
      "command": "npx",
      "args": ["-y", "@cowpin/mcp-server"],
      "env": {
        "COWPIN_AGENT_API_KEY": "cw_agent_your_api_key_here"
      }
    }
  }
}

3. Smithery One-Click Install

If you use the Smithery CLI:

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

🛠 Available Tools

Tool	Parameters	Description
`cowpin_save_memory`	`url` (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_memory`	`query` (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_page`	`id` (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 memory for any notes on PostgreSQL transaction isolation levels."

The assistant will automatically execute cowpin_save_memory and cowpin_search_memory behind the scenes!