Faceabot Stores MCP
An MCP server that helps AI agents find verified online stores for shopping in specific countries. It provides access to UCP (Universal Checkout Protocol) endpoints, big retailers, and Shopify cross-store catalogs, allowing agents to search for products, retrieve details, and perform read-only checks on store reliability and shipping capabilities.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://faceabot.com/tools-mcp/storesWhat you can do with it
- Find verified online stores for a product in a specific country
- Search product catalogs across multiple retailers
- Check store reliability and UCP compatibility for AI agents
Source and maintenance
Protocol and capabilities
- Server
- faceabot-stores 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 5 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
5 advertised
find_store — Find a store where an AI agent can shop
Where can I (an AI agent) shop for this product, for my human's country? Returns stores that Faceabot verified for agents: their UCP MCP endpoint (search_catalog, get_product, checkout), whether they ship to the country, plus the country's big retailers that let agents read (robots.txt) and the Shopify cross-store search. Any language. Use when: your user wants to buy something (washing machine, running shoes, perfume…). Example: {"query":"washing machine","country":"BE"}
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"description": "Product or need in any language, e.g. washing machine, lave-linge, 洗濯機"
},
"country": {
"type": "string",
"description": "Your human's country (ISO code or name), e.g. BE, Japan"
},
"category": {
"type": "string",
"description": "Optional category id (see list_store_categories)"
},
"agent_checkout_only": {
"type": "boolean",
"description": "true = only stores declaring agent checkout"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}store_details — What Faceabot measured on one store
One store's record: UCP version and MCP endpoint, capabilities, tools listed, countries it ships to, robots.txt rules for agents, last checks, and the exact search_catalog call. Example: {"domain":"allbirds.com","country":"US"}
{
"type": "object",
"required": [
"domain"
],
"properties": {
"query": {
"type": "string",
"description": "Optional product words for the call template"
},
"domain": {
"type": "string",
"description": "Store domain, e.g. allbirds.com"
},
"country": {
"type": "string",
"description": "Optional: your human's country, to check shipping"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_agent_profile — Get a UCP agent profile URL hosted by Faceabot (browse only)
UCP stores (Shopify and others) ask every agent for meta['ucp-agent'].profile: the https URL of a JSON file describing it. No website to publish one? Faceabot hosts yours, free: one URL per agent name, browse-only (catalog search and product lookup, no payment handler: it cannot pay). Same name = same URL. Faceabot never sees your searches. Example: {"agent_name":"Travel helper by Acme"}
{
"type": "object",
"required": [
"agent_name"
],
"properties": {
"agent_name": {
"type": "string",
"description": "Your agent's name (2-80 characters), ideally with its maker, e.g. \"Travel helper by Acme\""
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_store_categories — Store categories
The product categories Faceabot uses to classify stores, with how many verified stores each has.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ai_shopping_observatory — The AI shopping observatory
What AIs look for on Faceabot (by country and category), which stores let AI agents in, who charges what to be shown in AI answers (Google, OpenAI, Meta, Perplexity, Shopify… dated facts with sources), and Faceabot's weekly test for paid placements in Shopify's cross-store search. Example: {}
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"maximum": 365,
"minimum": 1
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 347 ms
- 95th percentile latency
- 347 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 347 ms · metadata changed · 5 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http faceabot-stores-mcp https://faceabot.com/tools-mcp/storesCodex
codex mcp add faceabot-stores-mcp --url https://faceabot.com/tools-mcp/storesCursor
{
"mcpServers": {
"faceabot-stores-mcp": {
"url": "https://faceabot.com/tools-mcp/stores"
}
}
}Cline
{
"mcpServers": {
"faceabot-stores-mcp": {
"type": "streamableHttp",
"url": "https://faceabot.com/tools-mcp/stores",
"disabled": false
}
}
}VS Code
{
"servers": {
"faceabot-stores-mcp": {
"type": "http",
"url": "https://faceabot.com/tools-mcp/stores"
}
}
}Gemini CLI
gemini mcp add --transport http faceabot-stores-mcp https://faceabot.com/tools-mcp/storesClaude Desktop
{
"mcpServers": {
"faceabot-stores-mcp": {
"url": "https://faceabot.com/tools-mcp/stores"
}
}
}Windsurf
{
"mcpServers": {
"faceabot-stores-mcp": {
"serverUrl": "https://faceabot.com/tools-mcp/stores"
}
}
}Let your agent find its tools
Find servers like Faceabot Stores MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Faceabot Stores MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.