Koskamo

Merchant Context MCP

Resolves sourced merchant facts and performs safe actions before an agent acts. It provides merchant discovery, resolution via a public MCP endpoint, and site diagnostics. The server supports checking merchant status and accessing sandbox merchants for testing.

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.

Merchant Context MCP logo, by Atom & BitsCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by Atom & Bits
MCP endpoint (Streamable HTTP)
https://api.merchant.atomandbits.com/mcp
Vendor documentation

What its tools do

9 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (7)

Can change data (2)

9 of 9 have a description · 9 of 9 declare behavior hints · 4 of 8 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Resolve merchant facts
  • Check merchant status
  • Discover merchants
  • Access sandbox merchants

Source and maintenance

Community listingRegistry 0.3.0
mcp-registry: io.github.ihint/merchant-context@0.3.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
merchant-context 0.3.0
MCP protocol negotiated in check
2025-11-25
Tools
9 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

9 advertised

get_service_info
Advertised by the server during the last successful anonymous check.
Advertised read-only

Describe the Merchant Context service, price, and inspection checks.

get_service_info input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_service_info annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
check_merchant
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Run a free merchant-site diagnostic. Agents should use resolve_merchant before relying on merchant facts or actions.

check_merchant input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url"
  ],
  "properties": {
    "merchant_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS merchant URL to check"
    }
  }
}
check_merchant annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
resolve_merchant
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Resolve cached merchant identity, sourced facts, offers, terms, freshness, and safe actions for free. Call this before relying on merchant facts or starting an action.

resolve_merchant input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url"
  ],
  "properties": {
    "client_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3,
      "description": "Stable, non-secret identifier for the calling client"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS merchant URL"
    }
  }
}
resolve_merchant annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
search_merchants
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Search cached merchant records by sourced offer, place, price, timing, policy, action support, and freshness. Payment and adoption never change order.

search_merchants input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "policy": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
    },
    "timing": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
    },
    "client_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3,
      "description": "Stable, non-secret identifier for the calling client"
    },
    "freshness": {
      "enum": [
        "fresh",
        "stale",
        "unknown",
        "any"
      ],
      "type": "string"
    },
    "geography": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
    },
    "action_type": {
      "enum": [
        "learn_more",
        "contact",
        "request_quote",
        "book",
        "checkout"
      ],
      "type": "string"
    },
    "item_or_service": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    },
    "max_stale_seconds": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "maximum_price_amount": {
      "type": "number",
      "minimum": 0
    },
    "maximum_price_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    }
  }
}
search_merchants annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
compare_offers
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Compare only sourced offer fields from two or more merchants. Unknown values stay unknown and payment never changes order.

compare_offers input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_urls"
  ],
  "properties": {
    "client_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3
    },
    "merchant_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 20,
      "minItems": 2
    }
  }
}
compare_offers annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_safe_actions
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Return current merchant-owned action URLs, exact inputs, authority, confirmation, expiry, retry rules, recovery, and attribution.

get_safe_actions input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url"
  ],
  "properties": {
    "client_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3
    },
    "action_type": {
      "enum": [
        "learn_more",
        "contact",
        "request_quote",
        "book",
        "checkout"
      ],
      "type": "string"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri"
    },
    "allowed_authority": {
      "type": "array",
      "items": {
        "enum": [
          "navigate",
          "prepare",
          "submit"
        ],
        "type": "string"
      }
    },
    "human_confirmation_available": {
      "type": "boolean"
    }
  }
}
get_safe_actions annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
preflight
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Resolve one merchant, evaluate sourced intent constraints, select a safe action, state approval, and return attribution.

preflight input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url"
  ],
  "properties": {
    "timing": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
    },
    "client_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3
    },
    "geography": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
    },
    "action_type": {
      "enum": [
        "learn_more",
        "contact",
        "request_quote",
        "book",
        "checkout"
      ],
      "type": "string"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri"
    },
    "item_or_service": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
    },
    "allowed_authority": {
      "type": "array",
      "items": {
        "enum": [
          "navigate",
          "prepare",
          "submit"
        ],
        "type": "string"
      }
    },
    "max_stale_seconds": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "maximum_price_amount": {
      "type": "number",
      "minimum": 0
    },
    "maximum_price_currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "human_confirmation_available": {
      "type": "boolean"
    }
  }
}
preflight annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
refresh_merchant
Advertised by the server during the last successful anonymous check.
Open-world

Pay for a fresh merchant inspection and cache refresh. Show the price and get explicit human approval first.

refresh_merchant input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url",
    "agent_id",
    "approved"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3,
      "description": "Stable, non-secret identifier for the calling agent"
    },
    "approved": {
      "type": "boolean",
      "const": true,
      "description": "Explicit human approval for this priced refresh"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS merchant URL"
    }
  }
}
refresh_merchant annotations
{
  "title": "Refresh merchant evidence",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
inspect_merchant
Advertised by the server during the last successful anonymous check.
Open-world

Compatibility alias for refresh_merchant. Show the price and get explicit human approval first.

inspect_merchant input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_url",
    "agent_id",
    "approved"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 3,
      "description": "Stable, non-secret identifier for the calling agent"
    },
    "approved": {
      "type": "boolean",
      "const": true,
      "description": "Explicit human approval for this priced refresh"
    },
    "merchant_url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS merchant URL"
    }
  }
}
inspect_merchant annotations
{
  "title": "Refresh merchant evidence",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

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
1041 ms
95th percentile latency
1041 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1041 ms · metadata changed · 9 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http merchant-context-mcp-atomandbits https://api.merchant.atomandbits.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add merchant-context-mcp-atomandbits --url https://api.merchant.atomandbits.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable merchant-context-mcp-atomandbits in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "merchant-context-mcp-atomandbits": {
      "url": "https://api.merchant.atomandbits.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "merchant-context-mcp-atomandbits": {
      "type": "streamableHttp",
      "url": "https://api.merchant.atomandbits.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start merchant-context-mcp-atomandbits and inspect its tools.
VS Code configuration
{
  "servers": {
    "merchant-context-mcp-atomandbits": {
      "type": "http",
      "url": "https://api.merchant.atomandbits.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http merchant-context-mcp-atomandbits https://api.merchant.atomandbits.com/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.merchant.atomandbits.com/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "merchant-context-mcp-atomandbits": {
      "serverUrl": "https://api.merchant.atomandbits.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Merchant Context MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,475