Repository avatar
AI Tools
v1.1.2
active

mcp-server

com.cowpin/mcp-server

Bookmark memory for AI agents: save links, search inside saved pages, recall what you read.

Documentation

Cowpin MCP server: bookmark memory for Claude, Cursor and AI agents

npm MCP Registry Cowpin MCP server — Glama quality score

The official Model Context Protocol server for Cowpin, the bookmark manager that keeps a readable copy of every page you save.

It gives your AI assistant a long-term memory of what you've read. It can save links, search inside the pages you saved (not just their titles), pull the full archived text of a page back into the conversation, and write a cited briefing across many saves. It works with Claude Desktop, Claude Code, Cursor, VS Code and any other MCP client.

npx -y @cowpin/mcp-server@latest

What your assistant can do

ToolWhat it does
cowpin_save_memorySave a link (or a piece of text) to your Cowpin library, with tags. Cowpin archives the page so it stays readable even if the site changes.
cowpin_search_memorySearch your library by meaning and by keyword, across the full text of saved pages. "What did I save about vector databases?"
cowpin_get_cached_pageLoad the full archived text of one saved page, without visiting the site again.
cowpin_synthesize_memoriesWrite a briefing across many saved pages on a topic, with citations.
cowpin_create_noteSave a markdown note (meeting notes, a research write-up) to your library.
cowpin_extract_urlRead a live page as clean markdown, without saving it.
cowpin_publish_to_feedShare a link with a summary on Cowpin's public feed (only when you ask it to).
cowpin_post_commentReply on a public feed item.
cowpin_check_balanceShow usage and credits for agent-wallet accounts.

Everything you save is private unless you publish it.

Quick start

1. Get your API token

Sign in at cowpin.com (14-day free trial, no card), then open Settings → API and create a token. Your account email must be verified.

Autonomous agents without a Cowpin account can use a wallet-based agent key (cw_agent_…) instead; see agent wallet auth.

2. Add Cowpin to your MCP client

Claude Desktop: edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "cowpin": {
      "command": "npx",
      "args": ["-y", "@cowpin/mcp-server@latest"],
      "env": { "COWPIN_API_KEY": "your-token-from-settings" }
    }
  }
}

Claude Code:

claude mcp add cowpin -e COWPIN_API_KEY=your-token-from-settings -- npx -y @cowpin/mcp-server@latest

Cursor: add the same block as Claude Desktop to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global). Step-by-step guide: Connect Cowpin to Cursor.

VS Code: add it under "servers" in .vscode/mcp.json, with "type": "stdio".

3. Try it

Save https://example.com/article to Cowpin with the tag "research".

What have I saved about sorting algorithms? Summarize the three most relevant pages.

Configuration

VariableRequiredDescription
COWPIN_API_KEYYesYour API token from Settings → API (or a cw_agent_… agent key). COWPIN_AGENT_API_KEY also works.
COWPIN_API_URLNoDefaults to https://www.cowpin.com/api/agent/mcp.

How it works

This package is a small, open-source stdio bridge. It forwards MCP JSON-RPC from your client to Cowpin's hosted MCP endpoint over HTTPS, with your token. It stores nothing on your machine and contains no hidden keys; read bin/cowpin-mcp.mjs.

Check it offline (runs the bridge against a mock gateway, no account needed):

npx -y @cowpin/mcp-server --self-test

From a checkout of cowpin-ai/mcp-server: npm test.

Listed in

About Cowpin

Cowpin is a bookmark manager and read-later app for people who save a lot. It's a Pinboard alternative and imports from Pocket, Raindrop.io and Instapaper. Every save gets an archived copy you can search, read later or listen to, on the web, iPhone, Android, Mac and in Chrome and Firefox.

Questions or problems: open an issue or email help@cowpin.com.

License

MIT

NPM
@cowpin/mcp-server
Install Command
npm install @cowpin/mcp-server