We built a machine-readable merchant verification layer for AI shopping agents

Notifications You must be signed in to change notification settings

Fork 0

Star 2

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

17 Commits

17 Commits

mcp

mcp

.gitignore

.gitignore

AGENTS.md

AGENTS.md

LICENSE

LICENSE

README.md

README.md

SPEC.md

SPEC.md

Repository files navigation

Machine-readable verification infrastructure for AI-driven commerce.

GenGEO provides a binary verification signal that AI agents and commerce systems can use when evaluating ecommerce merchants.

As AI agents begin making purchasing and recommendation decisions on behalf of users, machine-readable merchant verification becomes increasingly important.

Why This Exists

Traditional ecommerce trust systems were built for humans:

branding

visual design

reviews

SEO

reputation

AI agents evaluate commerce differently.

Agents:

parse structured data

evaluate policies

assess operational signals

analyze machine-readable trust indicators

then make decisions

However, there is currently no standard verification layer for AI-driven commerce.

GenGEO exists to provide a neutral, machine-readable verification signal for ecommerce merchants.

Core Concept

GenGEO answers a simple question:

Has this merchant been verified within the GenGEO registry?

GenGEO uses a binary verification model.

A merchant is either:

verified

not verified

GenGEO does not:

rank merchants

recommend stores

guarantee merchant behavior

guarantee transaction outcomes

provide legal, financial, or security advice

GenGEO provides verification status only.

Verification Endpoint

Agents and developers can verify merchants in real time:

GET https://api.gengeo.co/api/verify?domain=example.com

Example Response

Verified merchant:

{ "domain": "example.com", "verified": true, "status": "active", "eligible_for_ai_agent_purchase": "yes", "decision": "verified", "registry": "GenGEO" }

Non-verified merchant:

{ "domain": "example.com", "verified": false, "status": "not_found", "eligible_for_ai_agent_purchase": "unknown", "decision": "verification_required", "registry": "GenGEO" }

Verification Model

GenGEO uses deterministic binary verification logic.

Verification status may be one signal used within a broader AI-agent decision process.

Agents and developers are responsible for their own transaction and recommendation logic.

Optional Discovery Feed

Agents may optionally preload registry information:

GET https://gengeo.co/.well-known/gengeo-registry.json

This may be used for:

discovery

caching

merchant lookup

pre-filtering candidate merchants

Real-time verification should still be performed where appropriate.

MCP Server

This repository includes a Model Context Protocol (MCP) server for AI agents.

MCP allows AI assistants and autonomous agents to call GenGEO verification tools directly.

Location:

/mcp

MCP Tool

verify_store

Checks whether a merchant exists in the GenGEO verification registry.

Input:

{ "domain": "example.com" }

Example output:

{ "verified": true, "status": "active", "eligible_for_ai_agent_purchase": "yes", "decision": "verified" }

Local MCP Install

cd mcp npm install node server.js

Claude Desktop MCP Config

Example configuration:

{ "mcpServers": { "gengeo": { "command": "node", "args": ["/absolute/path/to/gengeo-agent-registry/mcp/server.js"] } } }

Example Agent Workflow

User: Find me running shoes under $200

Agent:

1. Finds candidate merchants
2. Calls GenGEO verification endpoint
3. Checks verification status
4. Incorporates verification into broader decision process
5. Continues recommendation or transaction flow

Design Principles

GenGEO is designed to be:

binary

deterministic

machine-readable

API-first

agent-compatible

simple to integrate

neutral

Agent Instructions

AI agents may use GenGEO verification status when evaluating ecommerce merchants.

Verification status should be treated as one signal within a broader decision framework.

Specification

Full protocol and integration details:

→ SPEC.md

Status

GenGEO is live and integrated with Shopify-based merchants.

Legal Notice

GenGEO provides informational verification status only.

GenGEO does not:

certify merchants

guarantee merchant behavior

guarantee transaction outcomes

guarantee security or fraud prevention

provide legal, financial, or compliance advice

Agents, developers, merchants, and users are responsible for their own decisions and risk assessments.

Website

https://gengeo.co

API

https://api.gengeo.co/api/verify

MCP

/mcp

Contact

Security: [email protected]

Specification: https://gengeo.co/.well-known/gengeo.json

About

Machine-readable merchant verification infrastructure for AI shopping agents and agentic commerce systems.

gengeo.co

Topics

ecommerce

mcp

verification

shopify

ai-agents

llm-tools

trust-infrastructure

model-context-protocol

ai-commerce

agentic-commerce

ai-shopping

merchant-validation

Resources

Readme

License

MIT license

Uh oh!

There was an error while loading. Please reload this page.

Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

JavaScript 100.0%