Cirkul

Cirkul Storefront Agent API

The agent-facing commerce surface Cirkul serves from its own drinkcirkul.com host. It comprises an anonymous Model Context Protocol (MCP) server at /api/mcp exposing five tools with real JSON Schema inputs (search_catalog, get_cart, update_cart, search_shop_policies_and_faqs, get_product_details), a Universal Commerce Protocol merchant discovery profile at /.well-known/ucp declaring cart, checkout, fulfillment, discount, order and catalog capabilities plus Shop Pay, Google Pay and card payment handlers, and a UCP shopping MCP endpoint at /api/ucp/mcp whose tools/list is gated behind a UCP agent-profile URI. Read-only catalog JSON (products.json, collection products.json) is documented for agents that only need to browse. Checkout explicitly requires contemporaneous human buyer approval.

GitHub

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/authentication/cirkul-authentication.yml

Other Resources

🔗
MCPServer
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/mcp/cirkul-mcp.yml
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/mcp/cirkul-tool-crosswalk.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/llms/cirkul-llms.txt
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/scopes/cirkul-scopes.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/errors/cirkul-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/conventions/cirkul-conventions.yml
🔗
AgentSkill
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/skills/_index.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/cirkul/refs/heads/main/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/storefront-agent-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

API entry from apis.yml

apis.yml Raw ↑ 
aid: cirkul:storefront-agent-api
name: Cirkul Storefront Agent API
description: The agent-facing commerce surface Cirkul serves from its own drinkcirkul.com host. It comprises
  an anonymous Model Context Protocol (MCP) server at /api/mcp exposing five tools with real JSON Schema
  inputs (search_catalog, get_cart, update_cart, search_shop_policies_and_faqs, get_product_details),
  a Universal Commerce Protocol merchant discovery profile at /.well-known/ucp declaring cart, checkout,
  fulfillment, discount, order and catalog capabilities plus Shop Pay, Google Pay and card payment handlers,
  and a UCP shopping MCP endpoint at /api/ucp/mcp whose tools/list is gated behind a UCP agent-profile
  URI. Read-only catalog JSON (products.json, collection products.json) is documented for agents that
  only need to browse. Checkout explicitly requires contemporaneous human buyer approval.
humanURL: https://drinkcirkul.com/agents.md
baseURL: https://drinkcirkul.com
tags:
- Agentic Commerce
- MCP
- Universal Commerce Protocol
- E-Commerce
- Catalog
- Cart
- Checkout
tags_raw:
- Agentic Commerce
- Model Context Protocol
- Universal Commerce Protocol
- Ecommerce
- Catalog
- Cart
- Checkout
properties:
- type: MCPServer
  url: mcp/cirkul-mcp.yml
- type: ToolCrosswalk
  url: mcp/cirkul-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/cirkul-llms.txt
- type: Authentication
  url: authentication/cirkul-authentication.yml
- type: OAuthScopes
  url: scopes/cirkul-scopes.yml
- type: ErrorCatalog
  url: errors/cirkul-problem-types.yml
- type: Conventions
  url: conventions/cirkul-conventions.yml
- type: AgentSkill
  url: skills/_index.yml