PerfectPay provides an MCP server named perfectpay-agent-commerce that exposes agent commerce capabilities as MCP tools for AI agents (ChatGPT, Claude, custom agents).
Server Connection
| Environment | MCP Server URL |
|---|
| Sandbox | https://sandbox.perfectpay.ai/agent-commerce/mcp |
| Production | https://api.perfectpay.ai/agent-commerce/mcp |
Server Info
| Field | Value |
|---|
| name | perfectpay-agent-commerce |
| version | 1.0.0 |
| protocol_version | 2024-11-05 |
| tools | enabled |
| resources | disabled |
| prompts | disabled |
| Tool | Purpose |
|---|
search_catalog | Search and browse merchant catalog data |
create_checkout | Start a checkout session |
check_authorization | Validate credential or budget authority |
get_order_status | Track an order |
negotiate_terms | Start or continue a negotiation |
Agent Commerce REST API
The same capabilities are also available as a REST API at /agent-commerce. This is the underlying HTTP surface that powers both the MCP tools and the UCP protocol adapter.
Catalog
| Endpoint | Method | Purpose |
|---|
/agent-commerce/catalog/products | POST | Create a product |
/agent-commerce/catalog/products | GET | List products |
/agent-commerce/catalog/products/bulk | POST | Bulk create products |
/agent-commerce/catalog/products/{id} | GET | Get a product |
/agent-commerce/catalog/products/{id} | PUT | Update a product |
/agent-commerce/catalog/products/{id} | DELETE | Archive a product |
/agent-commerce/catalog/agent-feed | GET | Get agent-optimized feed |
/agent-commerce/catalog/categories | GET | List GPC segments |
/agent-commerce/catalog/categories/{code}/children | GET | List GPC subcategories |
Credentials
| Endpoint | Method | Purpose |
|---|
/agent-commerce/credentials | POST | Issue a credential |
/agent-commerce/credentials | GET | List credentials |
/agent-commerce/credentials/{id} | GET | Get a credential |
/agent-commerce/credentials/{id}/confirm | POST | Confirm a credential |
/agent-commerce/credentials/{id}/revoke | POST | Revoke a credential |
/agent-commerce/credentials/revoke-all | POST | Revoke all credentials |
/agent-commerce/credentials/status/{list_id} | GET | Get status list |
Checkout
| Endpoint | Method | Purpose |
|---|
/agent-commerce/checkout | POST | Initiate checkout |
/agent-commerce/checkout/{id} | GET | Get checkout |
/agent-commerce/checkout/{id}/complete | POST | Complete checkout |
/agent-commerce/checkout/{id}/cancel | POST | Cancel checkout |
Approvals
| Endpoint | Method | Purpose |
|---|
/agent-commerce/approvals | GET | List approvals |
/agent-commerce/approvals/bulk | POST | Bulk approve/deny |
/agent-commerce/approvals/{id} | GET | Get approval |
/agent-commerce/approvals/{id}/approve | POST | Approve |
/agent-commerce/approvals/{id}/deny | POST | Deny |
Agents
| Endpoint | Method | Purpose |
|---|
/agent-commerce/agents/platforms | POST | Register a platform |
/agent-commerce/agents/platforms | GET | List platforms |
/agent-commerce/agents/platforms/{id} | GET | Get platform |
/agent-commerce/agents/register | POST | Register an agent |
/agent-commerce/agents/{id} | GET | Get agent |
/agent-commerce/agents/capabilities/{platform_id} | GET | Get platform capabilities |
Negotiations
| Endpoint | Method | Purpose |
|---|
/agent-commerce/negotiations | POST | Create negotiation |
/agent-commerce/negotiations | GET | List negotiations |
/agent-commerce/negotiations/{id} | GET | Get negotiation |
/agent-commerce/negotiations/{id}/action | POST | Submit action |
/agent-commerce/negotiations/{id}/accept | POST | Accept terms |
/agent-commerce/negotiations/{id}/reject | POST | Reject terms |
Analytics
| Endpoint | Method | Purpose |
|---|
/agent-commerce/analytics/overview | GET | Overview metrics |
/agent-commerce/analytics/revenue-by-platform | GET | Revenue by platform |
/agent-commerce/analytics/conversion-funnel | GET | Conversion funnel |
/agent-commerce/analytics/catalog-performance | GET | Catalog performance |
/agent-commerce/analytics/credentials | GET | Credential metrics |
/agent-commerce/analytics/export | POST | Export analytics |
Integration Notes
- Use MCP when the calling agent already supports tool invocation (ChatGPT, Claude, etc.)
- Use the UCP REST surface when you need explicit protocol-level interoperability
- Use the REST API directly when building custom integrations
- Keep credentials scoped tightly to the merchant, catalog, and budget constraints you want the agent to use
What This Means For Merchant Integrators
You do not have to design separate tool contracts yourself. PerfectPay already defines the tool names and input shapes for the core commerce actions most agent platforms need first. The same logic powers MCP tools, UCP protocol, and the REST API.