{
  "markdown": "# GenGEO Agent Registry\n\nMachine-readable trust infrastructure for autonomous commerce systems.\n\n[![smithery badge](https://smithery.ai/badge/warwick/gengeo)](https://smithery.ai/server/warwick/gengeo)\n\nGenGEO is building the world's largest merchant trust registry for AI agents and the foundation of a global reputation network for agentic commerce.\n\nGenGEO enables AI agents and developers to verify whether an ecommerce merchant meets a high operational verification threshold before autonomous purchasing or recommendation decisions are made.\n\nAs AI agents increasingly transact on behalf of users, a major infrastructure problem is emerging:\n\nThere is currently no standardized machine-readable trust layer for determining whether a merchant is operationally ready and appropriate for autonomous transactions.\n\nAt the same time, legitimate AI-driven commerce activity is increasingly colliding with fraud and bot-detection systems that cannot distinguish autonomous AI agents from malicious automation.\n\nAI agents can already:\n- discover products\n- browse stores\n- compare pricing\n- recommend merchants\n- and increasingly complete purchases\n\nBut there is still no common verification layer for evaluating merchant transaction readiness before autonomous commerce actions proceed.\n\nGenGEO helps reduce transaction uncertainty by providing a deterministic machine-readable verification signal that agents can incorporate into broader commerce decision frameworks.\n\n---\n\n\n# GenGEO\n\nTrust verification SDK for AI agents.\n\nVerify whether an ecommerce merchant meets GenGEO trust standards before recommending, purchasing, or transacting.\n\nGenGEO provides lightweight SDKs and APIs for merchant verification within autonomous commerce and AI-agent workflows.\n\n---\n\n## Install\n\n```bash\n# JavaScript / Node.js\nnpm install @gengeo/gengeo\n\n# Python\npip install gengeo\n````\n\n---\n\n## Quick Start\n\n### JavaScript / Node.js\n\n```javascript\nimport { verify } from '@gengeo/gengeo'\n\nconst result = await verify('store.example.com')\n\nconsole.log(result)\n\n/*\n{\n  verified: true,\n  decision: 'verified',\n  registry: 'gengeo'\n}\n*/\n```\n\n### Python\n\n```python\nfrom gengeo import verify\n\nresult = verify('store.example.com')\n\nprint(result)\n\n# {\n#   'verified': True,\n#   'decision': 'verified',\n#   'registry': 'gengeo'\n# }\n```\n\n### cURL\n\n```bash\ncurl \"https://api.gengeo.co/api/verify?domain=store.example.com\"\n```\n\n---\n\n## Why GenGEO?\n\nAI agents increasingly transact autonomously on behalf of users.\n\nGenGEO provides a standardized trust verification layer that helps agents evaluate whether a merchant is safe and transaction-ready before executing commerce actions.\n\n---\n\n## Use Cases\n\n* AI shopping agents\n* MCP commerce tools\n* Autonomous checkout workflows\n* Merchant trust verification\n* Agentic commerce infrastructure\n\n---\n\n## Docs\n\nFor MCP-enabled integrations and agent workflows:\n\n[https://gengeo.co/docs](https://gengeo.co/docs)\n\n[https://gengeo.co/acp](https://gengeo.co/acp)\n\n\n---\n\n# Why This Exists\n\nTraditional ecommerce trust systems were designed primarily for humans:\n- branding\n- visual design\n- reviews\n- SEO\n- reputation\n\nAutonomous agents evaluate commerce differently.\n\nAgents increasingly rely on:\n- structured data\n- machine-readable policies\n- operational signals\n- transaction readiness\n- trust infrastructure\n\nGenGEO exists to help address this emerging infrastructure gap through machine-readable merchant verification for autonomous commerce systems.\n\n---\n\n# Verification Model\n\nGenGEO uses a deterministic verification model designed to evaluate whether merchants meet a high operational verification threshold before autonomous agents proceed with commerce actions.\n\nVerification may include signals such as:\n- machine-readable policies\n- operational completeness\n- transaction readiness\n- structured commerce metadata\n- storefront verification state\n- agent compatibility checks\n\nThe goal is not to guarantee outcomes, but to provide autonomous systems with a stronger machine-readable trust signal that may improve transaction confidence within broader agent decision frameworks.\n\n---\n\n# Core Concept\n\nGenGEO answers a simple question:\n\n> Has this merchant been verified within the GenGEO registry?\n\nGenGEO uses a binary verification model.\n\nA merchant is either:\n- verified\n- not verified\n\nGenGEO does not:\n- rank merchants\n- recommend stores\n- guarantee merchant behavior\n- guarantee transaction outcomes\n- provide legal, financial, or security advice\n\nGenGEO provides verification status only.\n\n---\n\n# Documentation\n\nDeveloper documentation:\nhttps://gengeo.co/docs\n\nIncludes:\n- Verification API\n- MCP integration\n- ACP compatibility\n- Example responses\n- Verification methodology\n\n---\n\n\n# Verification Endpoint\n\nAgents and developers can verify merchants in real time:\n\n```http\nGET https://api.gengeo.co/api/verify?domain=example.com\n```\n\n---\n\n# Example Response\n\nVerified merchant:\n\n```json\n{\n  \"domain\": \"example.com\",\n  \"verified\": true,\n  \"status\": \"active\",\n  \"eligible_for_ai_agent_purchase\": \"yes\",\n  \"decision\": \"verified\",\n  \"registry\": \"GenGEO\"\n}\n```\n\nNon-verified merchant:\n\n```json\n{\n  \"domain\": \"example.com\",\n  \"verified\": false,\n  \"status\": \"not_found\",\n  \"eligible_for_ai_agent_purchase\": \"unknown\",\n  \"decision\": \"verification_required\",\n  \"registry\": \"GenGEO\"\n}\n```\n\n---\n\n# Verification Model\n\nGenGEO uses deterministic binary verification logic.\n\nVerification status may be one signal used within a broader AI-agent decision process.\n\nAgents and developers are responsible for their own transaction and recommendation logic.\n\n---\n\n# Optional Discovery Feed\n\nAgents may optionally preload registry information:\n\n```http\nGET https://gengeo.co/.well-known/gengeo-registry.json\n```\n\nThis may be used for:\n- discovery\n- caching\n- merchant lookup\n- pre-filtering candidate merchants\n\nReal-time verification should still be performed where appropriate.\n\n---\n\n# MCP Server\n\nThis repository includes a Model Context Protocol (MCP) server for AI agents.\n\nMCP allows AI assistants and autonomous agents to call GenGEO verification tools directly.\n\nLocation:\n\n```text\n/mcp\n```\n\n---\n\n# MCP Tool\n\n## verify_store\n\nChecks whether a merchant exists in the GenGEO verification registry.\n\nInput:\n\n```json\n{\n  \"domain\": \"example.com\"\n}\n```\n\nExample output:\n\n```json\n{\n  \"verified\": true,\n  \"status\": \"active\",\n  \"eligible_for_ai_agent_purchase\": \"yes\",\n  \"decision\": \"verified\"\n}\n```\n\n---\n\n# Local MCP Install\n\n```bash\ncd mcp\nnpm install\nnode server.js\n```\n\n---\n\n# Claude Desktop MCP Config\n\nExample configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"gengeo\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/gengeo-agent-registry/mcp/server.js\"]\n    }\n  }\n}\n```\n\n---\n\n# Open AI endpoint\n\nRemote MCP endpoint for ChatGPT Apps / OpenAI-compatible MCP clients:\n\n```text\nhttps://chatgpt-mcp.gengeo.co/mcp\n```\n\nThis endpoint exposes GenGEO merchant verification through a remote MCP server.\n\nLegacy/general MCP references may use:\n\n```text\nhttps://mcp.gengeo.co/mcp\n```\n\nFor ChatGPT Apps submission and OpenAI Developer Mode testing, use:\n\n```text\nhttps://chatgpt-mcp.gengeo.co/mcp\n```\n\n---\n\n# Example Agent Workflow\n\n```text\nUser:\nFind me running shoes under $200\n\nAgent:\n1. Finds candidate merchants\n2. Calls GenGEO verification endpoint\n3. Checks verification status\n4. Incorporates verification into broader decision process\n5. Continues recommendation or transaction flow\n```\n\n---\n\n# Design Principles\n\nGenGEO is designed to be:\n\n- binary\n- deterministic\n- machine-readable\n- API-first\n- agent-compatible\n- simple to integrate\n- neutral\n\n---\n\n# Agent Instructions\n\nAI agents may use GenGEO verification status when evaluating ecommerce merchants.\n\nVerification status should be treated as one signal within a broader decision framework.\n\n---\n\n# Specification\n\nFull protocol and integration details:\n\n→ [SPEC.md](./SPEC.md)\n\n---\n\n# Status\n\nGenGEO is live and integrated with Shopify-based merchants.\n\n---\n\n# Legal Notice\n\nGenGEO provides informational verification status only.\n\nGenGEO does not:\n- certify merchants\n- guarantee merchant behavior\n- guarantee transaction outcomes\n- guarantee security or fraud prevention\n- provide legal, financial, or compliance advice\n\nAgents, developers, merchants, and users are responsible for their own decisions and risk assessments.\n\n---\n\n# Website\n\n```text\nhttps://gengeo.co\n```\n\n---\n\n# API\n\n```text\nhttps://api.gengeo.co/api/verify\n```\n\n---\n\n# MCP\n\n```text\n/mcp\n\nLive remote MCP endpoint: https://mcp.gengeo.co/mcp\n```\n\n---\n\n# Developer docs\n\n```text\nhttps://gengeo.co/docs\n```\n\n---\n\n# ACP Overview\n\n```text\nhttps://gengeo.co/acp\n```\n\n---\n\n\n## How GenGEO Fits Into Agentic Commerce\n\n```text\nUser request\n   ↓\nAI shopping agent\n   ↓\nIdentifies merchant\n   ↓\nCalls GenGEO verify_store(domain)\n   ↓\nReceives verification status\n   ↓\nUses result as one signal in broader decision process\n```\n\n\n---\n\n# Contact\n\n- Security: support@gengeo.co\n- Specification: https://gengeo.co/.well-known/gengeo.json\n",
  "bytes": 8970,
  "sha": "b270008b3205a8fa71e39beb12c3f00d326abe39f47b7a8acec77984654ef375",
  "repo_slug": "warwickwood-cell/gengeo-agent-registry",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_warwickwood_cell_gengeo_8fb33e80/readme"
}