{
  "markdown": "# @verityscore/mcp-server\n\nMCP (Model Context Protocol) server for [Verity Score](https://verityscore.io) — the Shopify-first GEO audit platform.\n\n## 5 Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_geo_score` | GEO readiness score for a Shopify store (8 dimensions, top findings, report link) |\n| `check_ai_readiness` | Real-time check of 5 AI discovery files (robots.txt, llms.txt, ai.txt, agent-card.json, sitemap.xml) |\n| `get_recommendations` | Top 3 priority fixes with estimated revenue impact |\n| `explain_topic` | Expert guides on 19 GEO & AI commerce topics |\n| `get_vertical_info` | Checklists & benchmarks for 15 e-commerce verticals |\n\n## Quick Start\n\n### Use the hosted server (recommended)\n\nAdd to your Claude Desktop or MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"verity-score\": {\n      \"url\": \"https://mcp.verityscore.io/mcp\"\n    }\n  }\n}\n```\n\n### Run locally\n\n```bash\nnpx @verityscore/mcp-server\n```\n\nThe server starts on `http://localhost:3100/mcp`.\n\n### Test with curl\n\n```bash\n# List all tools\ncurl -X POST http://localhost:3100/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"method\":\"tools/list\",\"id\":1}'\n\n# Check AI readiness of any site\ncurl -X POST http://localhost:3100/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"method\":\"tools/call\",\"params\":{\"name\":\"check_ai_readiness\",\"arguments\":{\"domain\":\"mybrand.com\"}},\"id\":2}'\n```\n\n## Architecture\n\n- **Transport**: Streamable HTTP (stateless)\n- **Auth**: None (rate-limited to 10 req/min/IP)\n- **Protocol**: MCP v2025-03-26\n- **SDK**: `@modelcontextprotocol/sdk` v1.x\n\n## Tools Detail\n\n### `get_geo_score`\n\nReturns the GEO audit score for a Shopify store. If the store has been audited, returns scores across 8 dimensions + top 5 issues. If not yet audited, queues it for analysis within 72 hours.\n\n```\nInput:  { \"domain\": \"mybrand.com\" }\nOutput: { \"status\": \"audited\", \"scores\": [...], \"topIssues\": [...], \"reportUrl\": \"...\" }\n```\n\n### `check_ai_readiness`\n\nReal-time check of 5 AI discovery files. No database needed — fetches files directly from the target domain.\n\n```\nInput:  { \"domain\": \"mybrand.com\" }\nOutput: { \"score\": 3, \"maxScore\": 5, \"checks\": [...], \"recommendation\": \"...\" }\n```\n\n### `get_recommendations`\n\nReturns top 3 actionable fixes sorted by revenue impact.\n\n```\nInput:  { \"domain\": \"mybrand.com\" }\nOutput: { \"totalIssues\": 42, \"topRecommendations\": [{ \"priority\": 1, \"title\": \"...\", \"fix\": \"...\" }] }\n```\n\n### `explain_topic`\n\nExpert knowledge base covering 19 GEO topics. Fuzzy-matches by slug, tag, or title.\n\n```\nInput:  { \"topic\": \"schema.org\" }\nOutput: { \"title\": \"Schema.org Product: Why and How\", \"keyPoints\": [...], \"readMore\": {...} }\n```\n\n### `get_vertical_info`\n\nChecklists and benchmarks for 15 e-commerce verticals. Without argument, lists all verticals.\n\n```\nInput:  { \"vertical\": \"beauty\" }\nOutput: { \"checklist\": { \"requiredContent\": [...], \"expectedTrust\": [...] }, \"benchmarks\": {...} }\n```\n\n## Links\n\n- **Hosted MCP**: https://mcp.verityscore.io/mcp\n- **Website**: https://verityscore.io\n- **Free Audit**: https://verityscore.io/fr/\n- **Knowledge Base**: https://verityscore.io/en/kb/\n- **Agent Card**: https://verityscore.io/.well-known/agent-card.json\n\n## License\n\nMIT\n",
  "bytes": 3357,
  "sha": "d50cc611e802c5244d2e292edb0e371f623cf54faf7354056b01a95301957e0b",
  "repo_slug": "milka974/verityscore-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_verityscore_geo_audit_411b1fea/readme"
}