# Connect Agent Commerce Guard MCP

Agent Commerce Guard exposes a public, policy-only remote MCP server.

- Endpoint: `https://agent-commerce-guard.vercel.app/api/mcp`
- Registry name: `io.github.fxjim/agent-commerce-guard`
- Registry listing: https://registry.modelcontextprotocol.io/?search=agent-commerce-guard
- Server version: `1.2.0`
- Tool: `review_agent_commerce_actions`
- Offer resource: `https://agent-commerce-guard.vercel.app/offer.json`
- Prompt: `review-before-purchase`

The review tool is read-only, non-destructive, and purchase-free. It returns
sanitized policy decisions for non-sensitive proposed actions. The separate
offer resource contains the public 1 USDC Base offer and paid routes.
Initialization instructions point clients to that resource, require explicit
approval before payment, and require transaction verification after payment.
The guided prompt joins those steps without initiating or authorizing a
payment.

## Codex

```bash
codex mcp add agent-commerce-guard --url https://agent-commerce-guard.vercel.app/api/mcp
```

## Claude Code

```bash
claude mcp add --transport http agent-commerce-guard https://agent-commerce-guard.vercel.app/api/mcp
```

## VS Code

Add this server to your user or workspace `mcp.json`:

```json
{
  "servers": {
    "agent-commerce-guard": {
      "type": "http",
      "url": "https://agent-commerce-guard.vercel.app/api/mcp"
    }
  }
}
```

## Verify The Connection

Confirm that the client reports server version `1.2.0`, one tool named
`review_agent_commerce_actions`, and one resource at
`https://agent-commerce-guard.vercel.app/offer.json`, and one prompt named
`review-before-purchase`.

Try a policy-only request:

```text
Use Agent Commerce Guard to review a proposed read-only wallet balance check
and a proposed 1 USDC payment that has not received explicit approval.
```

The tool should allow the read-only check and deny or review the unapproved
payment. It does not sign, send, swap, deploy, publish, or purchase anything.

For a guided handoff, invoke `review-before-purchase`. It asks the client to
review non-sensitive actions, read the offer only when purchase is relevant,
show exact terms before payment, stop for explicit approval, and verify a later
transaction hash before claiming success.

## Public Offer

- Checkout: https://agent-commerce-guard.vercel.app/pay
- Buyer guide: https://agent-commerce-guard.vercel.app/buy
- Verify after payment: `https://agent-commerce-guard.vercel.app/verify?tx={tx}`
- Paid x402 download: https://agent-commerce-guard.vercel.app/api/x402-download
- Paid x402 evaluation: https://agent-commerce-guard.vercel.app/api/x402-evaluate

Payment counts only after onchain Base USDC transfer evidence or the live
transaction verifier confirms the exact receiver, token, network, and amount.

## Client References

- Codex MCP command example: https://github.com/openai/codex/blob/main/codex-rs/skills/src/assets/samples/openai-docs/SKILL.md
- Claude Code MCP setup: https://docs.anthropic.com/en/docs/claude-code/mcp
- VS Code MCP setup: https://code.visualstudio.com/docs/agent-customization/mcp-servers