FINESSE

FINESSE UCP Commerce MCP API

Agent-facing commerce endpoint implementing the Universal Commerce Protocol (version 2026-04-08, with 2026-01-23 also supported) over MCP/JSON-RPC 2.0. Thirteen tools cover catalog search and lookup, product detail, cart create/read/update/cancel, checkout create/read/update/complete/ cancel, and order retrieval. tools/list is anonymous; tool calls require a self-asserted meta.ucp-agent.profile URI, and payment completion requires contemporaneous human buyer approval. Money is expressed in ISO 4217 minor units.

GitHub

Documentation

📖
Documentation
https://finesse.us/agents.md
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/finesse/refs/heads/main/authentication/finesse-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/finesse/refs/heads/main/rate-limits/finesse-rate-limits.yml

Other Resources

🔗
MCPServer
https://raw.githubusercontent.com/api-evangelist/finesse/refs/heads/main/mcp/finesse-mcp.yml
🔗
MCPServer
https://finesse.us/api/ucp/mcp
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/finesse/refs/heads/main/conventions/finesse-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/finesse/refs/heads/main/errors/finesse-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/finesse/refs/heads/main/data-model/finesse-data-model.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/finesse/refs/heads/main/apis.yml

API entry from apis.yml

apis.yml Raw ↑ 
name: FINESSE UCP Commerce MCP API
description: Agent-facing commerce endpoint implementing the Universal Commerce Protocol (version 2026-04-08,
  with 2026-01-23 also supported) over MCP/JSON-RPC 2.0. Thirteen tools cover catalog search and lookup,
  product detail, cart create/read/update/cancel, checkout create/read/update/complete/ cancel, and order
  retrieval. tools/list is anonymous; tool calls require a self-asserted meta.ucp-agent.profile URI, and
  payment completion requires contemporaneous human buyer approval. Money is expressed in ISO 4217 minor
  units.
humanURL: https://finesse.us/agents.md
baseURL: https://finesse.us/api/ucp/mcp
tags:
- agentic-commerce
- ucp
- mcp
- ecommerce
- retail
- fashion
- agent-native
properties:
- type: MCPServer
  url: mcp/finesse-mcp.yml
- type: MCPServer
  url: https://finesse.us/api/ucp/mcp
- type: Documentation
  url: https://finesse.us/agents.md
- type: Authentication
  url: authentication/finesse-authentication.yml
- type: Conventions
  url: conventions/finesse-conventions.yml
- type: ErrorCatalog
  url: errors/finesse-problem-types.yml
- type: DataModel
  url: data-model/finesse-data-model.yml
- type: RateLimits
  url: rate-limits/finesse-rate-limits.yml