io.github.ilpr/shruwd-mcp
Set up a brand, read its AI-search visibility, and act on diagnostic findings.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http shruwd-mcp 'https://shruwd.io/mcp'{
"mcpServers": {
"shruwd-mcp": {
"type": "http",
"url": "https://shruwd.io/mcp"
}
}
}shruwd-mcpclaude mcp add shruwd-mcp -e 'SHRUWD_API_KEY=<your shruwd_api_key>' -e 'SHRUWD_API_URL=<SHRUWD_API_URL>' -- npx -y shruwd-mcp@0.1.9{
"mcpServers": {
"shruwd-mcp": {
"command": "npx",
"args": [
"-y",
"shruwd-mcp@0.1.9"
],
"env": {
"SHRUWD_API_KEY": "<your shruwd_api_key>",
"SHRUWD_API_URL": "<SHRUWD_API_URL>"
}
}
}
}Variables d'environnement
SHRUWD_API_KEYobligatoire secret API key minted in the Shruwd dashboard under Account -> API keys.SHRUWD_API_URLOverride the API base URL. Defaults to https://shruwd.io/api/v1.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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-mcpCursor
.cursor/mcp.json:
{
"mcpServers": {
"shruwd": {
"command": "npx",
"args": ["-y", "shruwd-mcp"],
"env": { "SHRUWD_API_KEY": "sh_live_…" }
}
}
}Tools
| Tool | Does |
|---|---|
shruwd_get_workspace | Plan, entitlements, usage, brands. Start here. |
shruwd_list_brands · shruwd_get_brand · shruwd_create_brand · shruwd_update_brand · shruwd_archive_brand | Brands. 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_prompt | The questions asked of each engine every cycle, and the page on your site that should answer each. |
shruwd_list_entities · shruwd_add_competitor · shruwd_set_entity · shruwd_remove_entity | The brand and its competitors, with the exact aliases that count as a mention. |
shruwd_run_measurement · shruwd_list_cycles | Measure now; watch the cycle. Results arrive over the following hours. |
shruwd_get_visibility · shruwd_get_visibility_series · shruwd_get_crawlers | Mention rate and share of voice with intervals, now and at every cycle close; verified AI-crawler activity. |
shruwd_list_crawler_paths | Which paths each crawler fetched and what it got: where a bot's errors came from. |
shruwd_list_answers | The latest individual answers: whether the brand was named and at what rank, the competitors named, the pages cited. Narrows to one prompt (a finding's subjectRef) or one engine. Evidence, not a metric. |
shruwd_list_suggestions · shruwd_accept_suggestion · shruwd_dismiss_suggestion | Competitors the answers named that the brand does not track yet. |
shruwd_suggest_setup | Drafts 10 to 25 prompts, each with the page that should answer it, and up to six competitors from the homepage and sitemap. Nothing is saved until they are added with the usual tools. |
shruwd_list_findings · shruwd_get_finding · shruwd_transition_finding | Diagnoses with a specific fix; mark a fix applied to start the recheck. Capped plans return the rest as a locked count. |
shruwd_create_ingest_token | The 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_KEY | Required. |
SHRUWD_API_URL | Optional. Defaults to https://shruwd.io/api/v1. |
Questions fréquentes
Qu'est-ce que io.github.ilpr/shruwd-mcp ?
Set up a brand, read its AI-search visibility, and act on diagnostic findings.
Comment installer io.github.ilpr/shruwd-mcp ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http shruwd-mcp 'https://shruwd.io/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.ilpr/shruwd-mcp ?
Oui. Il attend SHRUWD_API_KEY, à renseigner dans sa configuration.
io.github.ilpr/shruwd-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.ilpr/shruwd-mcp ?
Il est publié par ilpr. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.