About Verity Score
Verity Score is an MCP server for auditing Shopify stores’ generative-engine optimization readiness. It gives store teams scores, AI discovery checks, prioritized fixes, topic guides, and vertical checklists.
Key features
- 01Score Shopify GEO readiness
- 02Check AI discovery files
- 03Rank fixes by revenue impact
- 04Explain 19 GEO topics
- 05Provide 15 vertical checklists
Use cases
- 01Audit a Shopify store’s GEO status
- 02Check site files used for AI discovery
- 03Prioritize store optimization fixes
- 04Review guidance for an e-commerce vertical
MCP support
Exposes five tools to MCP clients over a hosted Streamable HTTP endpoint or a locally run server. The tools return audits, readiness checks, recommendations, topic guidance, and vertical information.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project README@verityscore/mcp-server
MCP (Model Context Protocol) server for Verity Score — the Shopify-first GEO audit platform.
5 Tools
| Tool | Description |
|---|---|
get_geo_score | GEO readiness score for a Shopify store (8 dimensions, top findings, report link) |
check_ai_readiness | Real-time check of 5 AI discovery files (robots.txt, llms.txt, ai.txt, agent-card.json, sitemap.xml) |
get_recommendations | Top 3 priority fixes with estimated revenue impact |
explain_topic | Expert guides on 19 GEO & AI commerce topics |
get_vertical_info | Checklists & benchmarks for 15 e-commerce verticals |
Quick Start
Use the hosted server (recommended)
Add to your Claude Desktop or MCP client config:
{
"mcpServers": {
"verity-score": {
"url": "https://mcp.verityscore.io/mcp"
}
}
}
Run locally
npx @verityscore/mcp-server
The server starts on http://localhost:3100/mcp.
Test with curl
# List all tools
curl -X POST http://localhost:3100/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
# Check AI readiness of any site
curl -X POST http://localhost:3100/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"check_ai_readiness","arguments":{"domain":"mybrand.com"}},"id":2}'
Architecture
- Transport: Streamable HTTP (stateless)
- Auth: None (rate-limited to 10 req/min/IP)
- Protocol: MCP v2025-03-26
- SDK:
@modelcontextprotocol/sdkv1.x
Tools Detail
get_geo_score
Returns 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.
Input: { "domain": "mybrand.com" }
Output: { "status": "audited", "scores": [...], "topIssues": [...], "reportUrl": "..." }
check_ai_readiness
Real-time check of 5 AI discovery files. No database needed — fetches files directly from the target domain.
Input: { "domain": "mybrand.com" }
Output: { "score": 3, "maxScore": 5, "checks": [...], "recommendation": "..." }
get_recommendations
Returns top 3 actionable fixes sorted by revenue impact.
Input: { "domain": "mybrand.com" }
Output: { "totalIssues": 42, "topRecommendations": [{ "priority": 1, "title": "...", "fix": "..." }] }
explain_topic
Expert knowledge base covering 19 GEO topics. Fuzzy-matches by slug, tag, or title.
Input: { "topic": "schema.org" }
Output: { "title": "Schema.org Product: Why and How", "keyPoints": [...], "readMore": {...} }
get_vertical_info
Checklists and benchmarks for 15 e-commerce verticals. Without argument, lists all verticals.
Input: { "vertical": "beauty" }
Output: { "checklist": { "requiredContent": [...], "expectedTrust": [...] }, "benchmarks": {...} }
Links
- Hosted MCP: https://mcp.verityscore.io/mcp
- Website: https://verityscore.io
- Free Audit: https://verityscore.io/fr/
- Knowledge Base: https://verityscore.io/en/kb/
- Agent Card: https://verityscore.io/.well-known/agent-card.json
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.