Verity Score
GEO audit for Shopify: AI readiness score, recommendations, and 15 vertical checklists.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@verityscore/mcp-serverclaude mcp add verity-score -- npx -y @verityscore/mcp-server@1.0.2
{
"mcpServers": {
"verity-score": {
"command": "npx",
"args": [
"-y",
"@verityscore/mcp-server@1.0.2"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
@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
Frequently asked questions
What is Verity Score?
GEO audit for Shopify: AI readiness score, recommendations, and 15 vertical checklists.
How do I install Verity Score?
It runs on your machine. In Claude Code: claude mcp add verity-score -- npx -y @verityscore/mcp-server@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Verity Score need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Verity Score open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Verity Score?
It is published by Milka974. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.