Back to Browse

Shruwd MCP Server

by Ilpr
Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Set up a brand, read its AI-search visibility, and act on diagnostic findings.

About

Set up a brand, read its AI-search visibility, and act on diagnostic findings.

Security Report

5.2
Moderate5.2Moderate Risk

Well-architected MCP server with proper authentication, no malicious patterns, and appropriate permission scoping. The server acts as a clean transport layer to the Shruwd API with comprehensive input validation via Zod. Minor code quality observations around error handling do not materially impact security, and all permissions align with the server's stated purpose of managing AI brand visibility monitoring. Supply chain analysis found 6 known vulnerabilities in dependencies (2 critical, 3 high severity). Package verification found 1 issue.

5 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

API key minted in the Shruwd dashboard under Account -> API keys.Required

Environment variable: SHRUWD_API_KEY

Override the API base URL. Defaults to https://shruwd.io/api/v1.Optional

Environment variable: SHRUWD_API_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-ilpr-shruwd-mcp": {
      "env": {
        "SHRUWD_API_KEY": "your-shruwd-api-key-here",
        "SHRUWD_API_URL": "your-shruwd-api-url-here"
      },
      "args": [
        "-y",
        "shruwd-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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 reaches your brands in it: every brand if you own the workspace, the brands you are a member of otherwise. It acts with your role on each brand: reads need viewer, writes editor, minting an ingest token admin; creating or archiving a brand needs the owner. To work across several workspaces, mint a key in each and add one server entry per workspace.

Hosted, no install

The same tools run at https://shruwd.io/mcp (Streamable HTTP). In Claude.ai, ChatGPT or Grok, add that URL as a custom connector and sign in with your Shruwd account; no key needed. A client that takes a header can send a key instead:

claude mcp add --transport http shruwd https://shruwd.io/mcp --header "Authorization: Bearer sh_live_…"

Setup for each app: shruwd.io/docs/api/mcp-server.

Claude Desktop

claude_desktop_config.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

ToolDoes
shruwd_get_workspacePlan, entitlements, usage, brands. Start here.
shruwd_list_brands · shruwd_get_brand · shruwd_create_brand · shruwd_update_brand · shruwd_archive_brandBrands. Creating one also creates its self entity and first measurement. Creating and archiving need owner.
shruwd_list_prompts · shruwd_add_prompts · shruwd_update_prompt · shruwd_remove_promptThe questions asked of each engine every cycle.
shruwd_list_entities · shruwd_add_competitor · shruwd_set_entity · shruwd_remove_entityThe brand and its competitors, with the exact aliases that count as a mention.
shruwd_run_measurement · shruwd_list_cyclesMeasure now; watch the cycle. Results arrive over the following hours.
shruwd_get_visibility · shruwd_get_visibility_series · shruwd_get_crawlersMention rate and share of voice with intervals, now and at every cycle close; verified AI-crawler activity.
shruwd_list_answersThe latest individual answers: whether the brand was named and at what rank, the competitors named, the pages cited. Evidence, not a metric.
shruwd_list_suggestions · shruwd_accept_suggestion · shruwd_dismiss_suggestionCompetitors the answers named that the brand does not track yet.
shruwd_suggest_setupDrafts ten prompts and up to six competitors from the homepage. Nothing is saved until they are added with the usual tools.
shruwd_list_findings · shruwd_get_finding · shruwd_transition_findingDiagnoses with a specific fix; mark a fix applied to start the recheck. Capped plans return the rest as a locked count.
shruwd_create_ingest_tokenThe token and endpoint for shipping server logs. Needs admin.

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

Variable
SHRUWD_API_KEYRequired.
SHRUWD_API_URLOptional. Defaults to https://shruwd.io/api/v1.

Reviews

No reviews yet

Be the first to review this server!