Shruwd MCP server

shruwd-mcp

A local MCP server for Shruwd. It lets an AI agent — Claude Desktop, Claude Code, Cursor, anything that speaks MCP — set up a brand, add the prompts and competitors to track, read how the brand appears in AI-generated answers, and act on the diagnostic findings.

You need an API key from the Shruwd dashboard (Account → API keys). The key is bound to one workspace and acts with your role in it: reads need viewer, writes editor, creating or archiving a brand owner, minting an ingest token admin. To work across several workspaces, mint a key in each and add one server entry per workspace.

Claude Desktop

claudedesktopconfig.json:

{
  "mcpServers": {
    "shruwd": {
      "command": "npx",
      "args": ["-y", "shruwd-mcp"],
      "env": { "SHRUWD_API_KEY": "sh_live_…" }
    }
  }
}

Claude Code

claude mcp add shruwd -e SHRUWD_API_KEY=sh_live_… -- npx -y shruwd-mcp

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "shruwd": {
      "command": "npx",
      "args": ["-y", "shruwd-mcp"],
      "env": { "SHRUWD_API_KEY": "sh_live_…" }
    }
  }
}

Tools

Every tool returns exactly what the API returns. Metrics are never bare numbers: each is a point estimate with its 95% interval and n, or an explicit insufficient_data state, which the tool descriptions tell the agent not to read as zero. Plans that cap visible findings report the remainder as a locked count rather than hiding that it exists.

Environment