From 30a37efac85598fc5102774b3508f28b8c211b79 Mon Sep 17 00:00:00 2001
From: Fabiano Cruz
Date: Thu, 27 Aug 2026 12:40:04 -0300
Subject: [PATCH 1/3] docs: catalog count matches the repo, and UCP/AP2 stop
implying a live endpoint
Two published claims did not hold against the code.
1) Server count. The README hero said "127 MCP servers" and the tables
listed 112 rows, while packages/ holds 129 directories with a
server.json (scripts/audit-catalog.py prints "Servers scanned: 129").
Seventeen servers existed in packages/ but appeared in no table:
argentina/payway, banking/iniciador, banking/midaz, banking/pluggy,
banking/pomelo, colombia/bold-co, colombia/cobre, colombia/epayco,
crypto/coinbase-cdp, identity/bigdatacorp, identity/caf,
identity/certta, mexico/clip, payments/flow-cl, payments/kushki,
payments/niubiz, payments/pagbrasil.
The hero no longer carries a hardcoded number (it drifted from 110 to
127 already), the seventeen missing rows are now in their category
tables, and every per-category header count now equals the number of
rows under it. Table rows: 129, one per packages///
server.json. Each new row's tool count comes from that package's own
"## Tools (N)" header and was cross-checked by counting the tool
declarations in its src/index.ts; each npm identifier matches that
package's package.json name. The hero pointer to
codespar.dev/api/servers no longer calls itself a count, because that
endpoint answers 133 today and does not match this repo.
2) UCP and AP2 endpoints. The protocol table sold "@codespar/mcp-ucp" as
"Google's full commerce stack for AI agents" and "@codespar/mcp-ap2"
with "60+ partners including Visa, Mastercard, Stripe, PayPal", with
nothing said about where the two servers actually point.
packages/payments/ucp/src/index.ts:69-71 calls
commerce.googleapis.com/ucp/v1 and packages/payments/ap2/src/index.ts:
60-62 calls ap2.googleapis.com/v1. Measured today: both answer the
Google frontend's generic "Error 404 (Not Found)" HTML page, the
response a *.googleapis.com name gives when no API service is
registered under it, while a registered service (storage.googleapis.com)
answers a structured JSON API error. Both sandbox hosts fail the TLS
handshake, since the wildcard certificate does not cover a fourth
label.
The two unprovable sentences are gone, both rows carry a "no live
endpoint" marker, and the root README, the two package READMEs and the
two source docstrings state what was measured. No behaviour changed:
the source edits are comments only.
Text only. Nothing was softened into "coming soon" or "planned", because
neither can be shown from the code today.
Co-Authored-By: Claude Opus 5 (1M context)
Claude-Session: https://claude.ai/code/session_01PSy1otpr7x4tHGRxBPQ6Cj
---
README.md | 41 ++++++++++++++++++++++--------
packages/payments/ap2/README.md | 2 ++
packages/payments/ap2/src/index.ts | 8 ++++++
packages/payments/ucp/README.md | 2 ++
packages/payments/ucp/src/index.ts | 7 +++++
5 files changed, 49 insertions(+), 11 deletions(-)
diff --git a/README.md b/README.md
index ed577f19..fef8a6af 100644
--- a/README.md
+++ b/README.md
@@ -5,10 +5,10 @@
Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols.
- 127 MCP servers for LATAM commerce · live in the official MCP Registry · MIT License
+ MCP servers for LATAM commerce · live in the official MCP Registry · MIT License
- Live machine-readable count: codespar.dev/api/servers
+ Machine-readable catalog: codespar.dev/api/servers
Catalog ·
@@ -59,10 +59,12 @@ Four servers that bridge the emerging agentic payment stack:
| Protocol | Server | Tools | What it does |
|----------|--------|-------|-------------|
-| **[Google UCP](packages/payments/ucp)** | `@codespar/mcp-ucp` | 20 | Universal Commerce Protocol — agentic shopping, cart, checkout, orders, delivery, identity. Google's full commerce stack for AI agents. |
+| **[Google UCP](packages/payments/ucp)** no live endpoint | `@codespar/mcp-ucp` | 20 | Universal Commerce Protocol — agentic shopping, cart, checkout, orders, delivery, identity. |
| **[Stripe ACP](packages/payments/stripe-acp)** | `@codespar/mcp-stripe-acp` | 24 | Agentic Commerce Protocol — AI agent checkout, payment delegation, products, invoices. Live in ChatGPT with 1M+ Shopify merchants. |
| **[x402](packages/crypto/x402)** | `@codespar/mcp-x402` | 10 | HTTP-native micropayments by Coinbase — when an agent hits a 402, it pays USDC on Base/Solana and retries. Pure HTTP, no checkout UI. |
-| **[AP2](packages/payments/ap2)** | `@codespar/mcp-ap2` alpha | 22 | Google's Agent-to-Agent Payment Protocol — authorization, audit trails, scoped spend limits. 60+ partners including Visa, Mastercard, Stripe, PayPal. |
+| **[AP2](packages/payments/ap2)** no live endpoint | `@codespar/mcp-ap2` alpha | 22 | Google's Agent-to-Agent Payment Protocol — authorization, audit trails, scoped spend limits. |
+
+> **No live endpoint behind UCP and AP2.** `@codespar/mcp-ucp` calls `https://commerce.googleapis.com/ucp/v1` (`BASE_URL`, `packages/payments/ucp/src/index.ts:69-71`) and `@codespar/mcp-ap2` calls `https://ap2.googleapis.com/v1` (`BASE_URL`, `packages/payments/ap2/src/index.ts:60-62`). Both addresses answer the Google frontend's generic `Error 404 (Not Found)` HTML page, which is what a `*.googleapis.com` name returns when no API service is registered under it; for contrast, a registered service such as `storage.googleapis.com` answers a structured JSON API error. The sandbox addresses selected by `UCP_SANDBOX` / `AP2_SANDBOX` do not complete the TLS handshake at all, because the `*.googleapis.com` certificate does not cover the fourth label in `sandbox.commerce.googleapis.com` / `sandbox.ap2.googleapis.com`. UCP and AP2 are open specifications; the 42 tool schemas in these two packages follow those specifications, but calls made through them fail before reaching any service.
### The Autonomy Spectrum
@@ -197,7 +199,7 @@ To orchestrate all six steps with governance, approval workflows, and audit trai
Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers). Each server has its own README, env-var requirements, and tool reference under `packages///`.
-### 💳 Payments (42 servers)
+### 💳 Payments (46 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
@@ -243,8 +245,12 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Efi](packages/payments/efi)** | 18 | `@codespar/mcp-efi` | API Key |
| **[Pix BCB](packages/payments/pix-bcb)** | 18 | `@codespar/mcp-pix-bcb` | API Key |
| **[Chargebee](packages/payments/chargebee)** | 15 | `@codespar/mcp-chargebee` | API Key |
+| **[Kushki](packages/payments/kushki)** | 10 | `@codespar/mcp-kushki` | API Key |
+| **[Flow.cl](packages/payments/flow-cl)** | 8 | `@codespar/mcp-flow-cl` | API Key |
+| **[Niubiz](packages/payments/niubiz)** | 4 | `@codespar/mcp-niubiz` | User/Password |
+| **[PagBrasil](packages/payments/pagbrasil)** | 3 | `@codespar/mcp-pagbrasil` | API Key |
-### 🏦 Banking (12 servers)
+### 🏦 Banking (16 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
@@ -256,10 +262,14 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Matera](packages/banking/matera)** alpha | 22 | `@codespar/mcp-matera` | OAuth2 |
| **[Dock](packages/banking/dock)** alpha | 20 | `@codespar/mcp-dock` | OAuth2 |
| **[Open Finance](packages/banking/open-finance)** | 18 | `@codespar/mcp-open-finance` | API Key |
+| **[Pluggy](packages/banking/pluggy)** | 16 | `@codespar/mcp-pluggy` | API Key |
| **[C6](packages/banking/c6)** alpha | 14 | `@codespar/mcp-c6` | OAuth2 |
| **[Banco Do Brasil](packages/banking/banco-do-brasil)** alpha | 13 | `@codespar/mcp-banco-do-brasil` | OAuth2 |
| **[Sicoob](packages/banking/sicoob)** alpha | 13 | `@codespar/mcp-sicoob` | OAuth2 |
| **[BTG](packages/banking/btg)** alpha | 12 | `@codespar/mcp-btg` | OAuth2 |
+| **[Iniciador](packages/banking/iniciador)** | 9 | `@codespar/mcp-iniciador` | API Key |
+| **[Pomelo](packages/banking/pomelo)** | 9 | `@codespar/mcp-pomelo` | OAuth2 |
+| **[Midaz](packages/banking/midaz)** | 5 | `@codespar/mcp-midaz` | API Key (optional) |
### 📄 Fiscal (Brasil) (4 servers)
@@ -305,7 +315,7 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Quickbooks](packages/erp/quickbooks)** | 22 | `@codespar/mcp-quickbooks` | API Key |
| **[Tiny](packages/erp/tiny)** | 21 | `@codespar/mcp-tiny` | API Key |
-### 🪪 Identity & KYC (5 servers)
+### 🪪 Identity & KYC (8 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
@@ -314,6 +324,9 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Onfido](packages/identity/onfido)** | 20 | `@codespar/mcp-onfido` | API Key |
| **[Persona](packages/identity/persona)** | 20 | `@codespar/mcp-persona` | API Key |
| **[Unico](packages/identity/unico)** alpha | 18 | `@codespar/mcp-unico` | OAuth2 |
+| **[Certta](packages/identity/certta)** | 11 | `@codespar/mcp-certta` | API Key |
+| **[BigDataCorp](packages/identity/bigdatacorp)** | 10 | `@codespar/mcp-bigdatacorp` | API Key |
+| **[Caf](packages/identity/caf)** | 9 | `@codespar/mcp-caf` | API Key |
### 🛡️ Fraud & Risk (4 servers)
@@ -324,7 +337,7 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Konduto](packages/fraud/konduto)** alpha | 18 | `@codespar/mcp-konduto` | API Key |
| **[Legiti](packages/fraud/legiti)** alpha | 18 | `@codespar/mcp-legiti` | API Key |
-### 🪙 Crypto / Stablecoins (9 servers)
+### 🪙 Crypto / Stablecoins (10 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
@@ -336,9 +349,10 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Unblockpay](packages/crypto/unblockpay)** | 13 | `@codespar/mcp-unblockpay` | API Key |
| **[Coinbase Commerce](packages/crypto/coinbase-commerce)** | 18 | `@codespar/mcp-coinbase-commerce` | API Key |
| **[Transak](packages/crypto/transak)** alpha | 18 | `@codespar/mcp-transak` | API Key |
+| **[Coinbase CDP](packages/crypto/coinbase-cdp)** | 15 | `@codespar/mcp-coinbase-cdp` | API Key |
| **[x402](packages/crypto/x402)** | 10 | `@codespar/mcp-x402` | API Key |
-### 🇦🇷 Argentina (5 servers)
+### 🇦🇷 Argentina (6 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
@@ -347,8 +361,9 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[AFIP](packages/argentina/afip)** alpha | 20 | `@codespar/mcp-afip` | API Key |
| **[Andreani](packages/argentina/andreani)** alpha | 18 | `@codespar/mcp-andreani` | API Key |
| **[BCRA](packages/argentina/bcra)** | 16 | `@codespar/mcp-bcra` | No auth |
+| **[Payway](packages/argentina/payway)** | 6 | `@codespar/mcp-payway` | API Key |
-### 🇨🇴 Colombia (5 servers)
+### 🇨🇴 Colombia (8 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
@@ -357,8 +372,11 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Alegra](packages/colombia/alegra)** | 20 | `@codespar/mcp-alegra` | API Key |
| **[Coordinadora](packages/colombia/coordinadora)** alpha | 19 | `@codespar/mcp-coordinadora` | API Key |
| **[Nequi](packages/colombia/nequi)** alpha | 16 | `@codespar/mcp-nequi` | OAuth2 |
+| **[Cobre](packages/colombia/cobre)** | 8 | `@codespar/mcp-cobre` | API Key |
+| **[ePayco](packages/colombia/epayco)** | 8 | `@codespar/mcp-epayco` | API Key |
+| **[Bold](packages/colombia/bold-co)** | 7 | `@codespar/mcp-bold-co` | API Key |
-### 🇲🇽 Mexico (6 servers)
+### 🇲🇽 Mexico (7 servers)
| Server | Tools | npm | Auth |
|---|---|---|---|
@@ -368,6 +386,7 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Bind ERP](packages/mexico/bind-erp)** | 20 | `@codespar/mcp-bind-erp` | API Key |
| **[Facturapi](packages/mexico/facturapi)** | 20 | `@codespar/mcp-facturapi` | API Key |
| **[STP/SPEI](packages/mexico/stp-spei)** alpha | 18 | `@codespar/mcp-stp-spei` | API Key |
+| **[Clip](packages/mexico/clip)** | 6 | `@codespar/mcp-clip` | API Key |
---
diff --git a/packages/payments/ap2/README.md b/packages/payments/ap2/README.md
index 26cc3965..f03b6eaa 100644
--- a/packages/payments/ap2/README.md
+++ b/packages/payments/ap2/README.md
@@ -8,6 +8,8 @@
[](https://www.npmjs.com/package/@codespar/mcp-ap2)
[](https://opensource.org/licenses/MIT)
+> **No live endpoint.** This server calls `https://ap2.googleapis.com/v1` (`BASE_URL`, `src/index.ts:60-62`). That address answers the Google frontend's generic `Error 404 (Not Found)` HTML page, which is what a `*.googleapis.com` name returns when no API service is registered under it; a registered service such as `storage.googleapis.com` answers a structured JSON API error instead. With `AP2_SANDBOX=true` the request does not complete the TLS handshake, because the `*.googleapis.com` certificate does not cover the fourth label in `sandbox.ap2.googleapis.com`. AP2 is an open specification; the 22 tool schemas below follow it, but calls made through them fail before reaching any service.
+
## What is AP2?
AP2 (Agent-to-Agent Payment Protocol) is Google's open framework for **authorization, audit, and trust** in agentic payments. It answers the critical questions: *Who authorized this payment? What limits apply? What's the full audit trail?*
diff --git a/packages/payments/ap2/src/index.ts b/packages/payments/ap2/src/index.ts
index 343eca40..d71013c6 100644
--- a/packages/payments/ap2/src/index.ts
+++ b/packages/payments/ap2/src/index.ts
@@ -7,6 +7,14 @@
* for AI agents making payments. It defines who authorized a payment,
* what limits apply, and maintains a complete audit trail.
*
+ * NO LIVE ENDPOINT: BASE_URL below points at ap2.googleapis.com (and
+ * sandbox.ap2.googleapis.com), which is not a registered Google API
+ * service. The production host answers the Google frontend's generic
+ * "Error 404 (Not Found)" HTML page; the sandbox host fails the TLS
+ * handshake because the *.googleapis.com certificate does not cover a
+ * fourth label. AP2 is an open specification, not an API served here.
+ * The tool schemas below follow the spec; the calls do not land.
+ *
* Tools:
* - register_agent: Register an AI agent as a trusted payer in AP2
* - get_agent: Get agent registration details and trust status
diff --git a/packages/payments/ucp/README.md b/packages/payments/ucp/README.md
index c641c73f..22493569 100644
--- a/packages/payments/ucp/README.md
+++ b/packages/payments/ucp/README.md
@@ -5,6 +5,8 @@
[](https://www.npmjs.com/package/@codespar/mcp-ucp)
[](https://opensource.org/licenses/MIT)
+> **No live endpoint.** This server calls `https://commerce.googleapis.com/ucp/v1` (`BASE_URL`, `src/index.ts:69-71`). That address answers the Google frontend's generic `Error 404 (Not Found)` HTML page, which is what a `*.googleapis.com` name returns when no API service is registered under it; a registered service such as `storage.googleapis.com` answers a structured JSON API error instead. With `UCP_SANDBOX=true` the request does not complete the TLS handshake, because the `*.googleapis.com` certificate does not cover the fourth label in `sandbox.commerce.googleapis.com`. UCP is an open specification; the 20 tool schemas below follow it, but calls made through them fail before reaching any service.
+
## What is UCP?
**Universal Commerce Protocol (UCP)** is Google's open standard for agentic commerce. It enables AI agents to autonomously discover products, build carts, checkout, manage orders, and track deliveries — without screen-scraping or bespoke merchant integrations.
diff --git a/packages/payments/ucp/src/index.ts b/packages/payments/ucp/src/index.ts
index 4d10a1bb..9605b684 100644
--- a/packages/payments/ucp/src/index.ts
+++ b/packages/payments/ucp/src/index.ts
@@ -56,6 +56,13 @@ import {
ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";
+// NO LIVE ENDPOINT: BASE_URL below points at commerce.googleapis.com (and
+// sandbox.commerce.googleapis.com), which is not a registered Google API
+// service. The production host answers the Google frontend's generic
+// "Error 404 (Not Found)" HTML page; the sandbox host fails the TLS
+// handshake because the *.googleapis.com certificate does not cover a
+// fourth label. UCP is an open specification, not an API served here.
+// The tool schemas below follow the spec; the calls do not land.
const API_KEY = process.env.UCP_API_KEY || "";
const MERCHANT_ID = process.env.UCP_MERCHANT_ID || "";
const SANDBOX = process.env.UCP_SANDBOX === "true";
From de7e2bab088814383ac65005b421db57b0c86779 Mon Sep 17 00:00:00 2001
From: Fabiano Cruz
Date: Thu, 27 Aug 2026 13:12:38 -0300
Subject: [PATCH 2/3] docs: replace the unprovable claims the review flagged,
and sweep their duplicates
The previous commit replaced false claims with new claims that were also
unprovable, and left copies of the old ones standing. This reworks both.
Claims removed because nothing supports them:
- "the 42 tool schemas ... follow those specifications" (5 surfaces). We never
checked a schema against a spec. The banners now state only what was
observed, and say plainly that the definitions are unverified.
- "which is what a *.googleapis.com name returns when no API service is
registered under it": a causal law inferred from one probe. Replaced by the
observation plus its controls.
- "60+ partners including Visa, Mastercard, Stripe, PayPal, and Square", which
survived in ap2/README.md:17, and the same partner list restated in the
list_payment_methods description (README table and src/index.ts).
- "AP2 provides a sandbox environment for testing", which survived in the file
the PR edited. The sandbox host fails TLS.
- "Live in ChatGPT with 1M+ Shopify merchants", in the root table and again in
stripe-acp/README.md:12.
- The credential steps for developers.google.com/ap2 and
developers.google.com/agents/commerce, and the github.com/anthropic-payments
spec link. All three answer 404. The dead UCP URL was also published as
provider.docsUrl in server.json.
- "Endpoint paths follow public docs" in the AP2 alpha notice: the same
conformance claim the review rejected, seven lines above the new banner.
Consistency, since the review found the criterion applied unevenly:
- x402 gets the same treatment as UCP and AP2. api.x402.org is NXDOMAIN on
8.8.8.8 and 1.1.1.1 while x402.org itself resolves, so its BASE_URL reaches
nothing either. Marked in both tables and in the banner.
- The "no live endpoint" marker now appears in the catalog table too, not only
the protocol table.
- x402/server.json claimed sandbox.available: true. The package has no sandbox
switch at all, so it now reads false, matching UCP and AP2.
Every line reference was re-resolved after the source edits moved them.
Co-Authored-By: Claude Opus 5 (1M context)
Claude-Session: https://claude.ai/code/session_01PSy1otpr7x4tHGRxBPQ6Cj
---
README.md | 24 ++++++++++++++------
packages/crypto/x402/server.json | 2 +-
packages/payments/ap2/README.md | 31 +++++++++-----------------
packages/payments/ap2/src/index.ts | 24 +++++++++++---------
packages/payments/stripe-acp/README.md | 2 --
packages/payments/ucp/README.md | 14 +++++-------
packages/payments/ucp/server.json | 1 -
packages/payments/ucp/src/index.ts | 22 +++++++++---------
8 files changed, 59 insertions(+), 61 deletions(-)
diff --git a/README.md b/README.md
index fef8a6af..ca8575a8 100644
--- a/README.md
+++ b/README.md
@@ -55,16 +55,26 @@ Each MCP server in this repo wraps a real provider — payments, fiscal, logisti
## Agentic Payment Protocols
-Four servers that bridge the emerging agentic payment stack:
+Four servers for the emerging agentic payment stack:
| Protocol | Server | Tools | What it does |
|----------|--------|-------|-------------|
| **[Google UCP](packages/payments/ucp)** no live endpoint | `@codespar/mcp-ucp` | 20 | Universal Commerce Protocol — agentic shopping, cart, checkout, orders, delivery, identity. |
-| **[Stripe ACP](packages/payments/stripe-acp)** | `@codespar/mcp-stripe-acp` | 24 | Agentic Commerce Protocol — AI agent checkout, payment delegation, products, invoices. Live in ChatGPT with 1M+ Shopify merchants. |
-| **[x402](packages/crypto/x402)** | `@codespar/mcp-x402` | 10 | HTTP-native micropayments by Coinbase — when an agent hits a 402, it pays USDC on Base/Solana and retries. Pure HTTP, no checkout UI. |
+| **[Stripe ACP](packages/payments/stripe-acp)** | `@codespar/mcp-stripe-acp` | 24 | Agentic Commerce Protocol — AI agent checkout, payment delegation, products, invoices. |
+| **[x402](packages/crypto/x402)** no live endpoint | `@codespar/mcp-x402` | 10 | HTTP-native micropayments by Coinbase — when an agent hits a 402, it pays USDC on Base/Solana and retries. Pure HTTP, no checkout UI. |
| **[AP2](packages/payments/ap2)** no live endpoint | `@codespar/mcp-ap2` alpha | 22 | Google's Agent-to-Agent Payment Protocol — authorization, audit trails, scoped spend limits. |
-> **No live endpoint behind UCP and AP2.** `@codespar/mcp-ucp` calls `https://commerce.googleapis.com/ucp/v1` (`BASE_URL`, `packages/payments/ucp/src/index.ts:69-71`) and `@codespar/mcp-ap2` calls `https://ap2.googleapis.com/v1` (`BASE_URL`, `packages/payments/ap2/src/index.ts:60-62`). Both addresses answer the Google frontend's generic `Error 404 (Not Found)` HTML page, which is what a `*.googleapis.com` name returns when no API service is registered under it; for contrast, a registered service such as `storage.googleapis.com` answers a structured JSON API error. The sandbox addresses selected by `UCP_SANDBOX` / `AP2_SANDBOX` do not complete the TLS handshake at all, because the `*.googleapis.com` certificate does not cover the fourth label in `sandbox.commerce.googleapis.com` / `sandbox.ap2.googleapis.com`. UCP and AP2 are open specifications; the 42 tool schemas in these two packages follow those specifications, but calls made through them fail before reaching any service.
+> **No live endpoint behind UCP, AP2, and x402.** Checked on 2026-08-27:
+>
+> | Server | `BASE_URL` in source | What that address answered |
+> |---|---|---|
+> | `@codespar/mcp-ucp` | `https://commerce.googleapis.com/ucp/v1` (`packages/payments/ucp/src/index.ts:71-73`) | HTTP 404, Google's generic `Error 404 (Not Found)` HTML page |
+> | `@codespar/mcp-ap2` | `https://ap2.googleapis.com/v1` (`packages/payments/ap2/src/index.ts:62-64`) | HTTP 404, the same generic HTML page |
+> | `@codespar/mcp-x402` | `https://api.x402.org/v1` (`packages/crypto/x402/src/index.ts:40`) | `NXDOMAIN`, the host does not resolve |
+>
+> Controls on the same network and resolvers: `storage.googleapis.com` and `translate.googleapis.com` each answered a structured JSON API error, and `x402.org` itself resolved and answered HTTP 200. The sandbox addresses selected by `UCP_SANDBOX` and `AP2_SANDBOX` fail earlier still, at TLS, because the certificate served there covers `*.googleapis.com` and not the extra label in `sandbox.commerce.googleapis.com` or `sandbox.ap2.googleapis.com`.
+>
+> UCP, AP2, and x402 are published specifications, and these three packages ship tool definitions written for them. We have not checked those definitions against a conforming implementation, and no call made through the three servers currently reaches a service.
### The Autonomy Spectrum
@@ -213,7 +223,7 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Stripe ACP](packages/payments/stripe-acp)** | 24 | `@codespar/mcp-stripe-acp` | API Key |
| **[Iugu](packages/payments/iugu)** | 23 | `@codespar/mcp-iugu` | API Key |
| **[Openpay](packages/payments/openpay)** | 23 | `@codespar/mcp-openpay` | API Key |
-| **[AP2](packages/payments/ap2)** alpha | 22 | `@codespar/mcp-ap2` | API Key |
+| **[AP2](packages/payments/ap2)** alpha no live endpoint | 22 | `@codespar/mcp-ap2` | API Key |
| **[Braintree](packages/payments/braintree)** | 22 | `@codespar/mcp-braintree` | API Key |
| **[Braspag](packages/payments/braspag)** | 22 | `@codespar/mcp-braspag` | API Key |
| **[Cielo](packages/payments/cielo)** | 22 | `@codespar/mcp-cielo` | API Key |
@@ -235,7 +245,7 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Getnet](packages/payments/getnet)** | 20 | `@codespar/mcp-getnet` | OAuth2 |
| **[Izipay](packages/payments/izipay)** alpha | 20 | `@codespar/mcp-izipay` | API Key |
| **[Picpay](packages/payments/picpay)** alpha | 20 | `@codespar/mcp-picpay` | API Key |
-| **[UCP](packages/payments/ucp)** | 20 | `@codespar/mcp-ucp` | API Key |
+| **[UCP](packages/payments/ucp)** no live endpoint | 20 | `@codespar/mcp-ucp` | API Key |
| **[Vindi](packages/payments/vindi)** | 20 | `@codespar/mcp-vindi` | API Key |
| **[Paypal](packages/payments/paypal)** | 19 | `@codespar/mcp-paypal` | OAuth2 |
| **[Transbank](packages/payments/transbank)** alpha | 19 | `@codespar/mcp-transbank` | API Key |
@@ -350,7 +360,7 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
| **[Coinbase Commerce](packages/crypto/coinbase-commerce)** | 18 | `@codespar/mcp-coinbase-commerce` | API Key |
| **[Transak](packages/crypto/transak)** alpha | 18 | `@codespar/mcp-transak` | API Key |
| **[Coinbase CDP](packages/crypto/coinbase-cdp)** | 15 | `@codespar/mcp-coinbase-cdp` | API Key |
-| **[x402](packages/crypto/x402)** | 10 | `@codespar/mcp-x402` | API Key |
+| **[x402](packages/crypto/x402)** no live endpoint | 10 | `@codespar/mcp-x402` | API Key |
### 🇦🇷 Argentina (6 servers)
diff --git a/packages/crypto/x402/server.json b/packages/crypto/x402/server.json
index 5803b5d4..1662230b 100644
--- a/packages/crypto/x402/server.json
+++ b/packages/crypto/x402/server.json
@@ -33,7 +33,7 @@
"logoFallback": "https://www.google.com/s2/favicons?domain=x402.org&sz=128",
"docsUrl": "https://x402.org",
"sandbox": {
- "available": true
+ "available": false
}
}
}
diff --git a/packages/payments/ap2/README.md b/packages/payments/ap2/README.md
index f03b6eaa..4d4a395e 100644
--- a/packages/payments/ap2/README.md
+++ b/packages/payments/ap2/README.md
@@ -1,20 +1,20 @@
# @codespar/mcp-ap2
-> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install @alpha`.
+> **Alpha release** — published under the `alpha` npm dist-tag. Pin exact versions during `0.x.x-alpha`. Install with `npm install @alpha`.
> MCP server for **AP2** — Google's Agent-to-Agent Payment Protocol (authorization, audit, and trust for agentic payments)
[](https://www.npmjs.com/package/@codespar/mcp-ap2)
[](https://opensource.org/licenses/MIT)
-> **No live endpoint.** This server calls `https://ap2.googleapis.com/v1` (`BASE_URL`, `src/index.ts:60-62`). That address answers the Google frontend's generic `Error 404 (Not Found)` HTML page, which is what a `*.googleapis.com` name returns when no API service is registered under it; a registered service such as `storage.googleapis.com` answers a structured JSON API error instead. With `AP2_SANDBOX=true` the request does not complete the TLS handshake, because the `*.googleapis.com` certificate does not cover the fourth label in `sandbox.ap2.googleapis.com`. AP2 is an open specification; the 22 tool schemas below follow it, but calls made through them fail before reaching any service.
+> **No live endpoint.** Checked on 2026-08-27. This server's `BASE_URL` (`src/index.ts:62-64`) is `https://ap2.googleapis.com/v1`, which answers HTTP 404 with Google's generic `Error 404 (Not Found)` HTML page instead of an API response. With `AP2_SANDBOX=true` the address becomes `https://sandbox.ap2.googleapis.com/v1`, which fails the TLS handshake, because the certificate served there covers `*.googleapis.com` and not the extra label. As controls on the same run, `storage.googleapis.com` and `translate.googleapis.com` each answered a structured JSON API error. AP2 is a published specification and this package ships tool definitions written for it; we have not checked them against a conforming implementation, and no call made through this server currently reaches a service.
## What is AP2?
AP2 (Agent-to-Agent Payment Protocol) is Google's open framework for **authorization, audit, and trust** in agentic payments. It answers the critical questions: *Who authorized this payment? What limits apply? What's the full audit trail?*
-With 60+ partners including Visa, Mastercard, Stripe, PayPal, and Square, AP2 is the emerging standard for agent payment governance.
+The specification is published at [ap2-protocol.org](https://ap2-protocol.org).
## Quick Start
@@ -76,7 +76,7 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
| `execute_payment` | Execute an authorized payment. |
| `get_audit_trail` | Get the complete audit trail for a transaction — every authorization, approval, execution, and settlement e... |
| `list_audit_events` | List audit events across all transactions with filters |
-| `list_payment_methods` | List available payment methods from AP2 partner network (Visa, Mastercard, Stripe, PayPal, etc.) |
+| `list_payment_methods` | List payment methods offered by the AP2 partner network |
| `get_transaction` | Get full transaction details including authorization, execution, and settlement status |
| `list_transactions` | List transactions with optional filters |
| `create_intent_mandate` | Create an AP2 intent mandate — a Verifiable Credential expressing the user's intent to delegate a transacti... |
@@ -91,27 +91,17 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
## Authentication
-AP2 uses a Bearer API key and requires a registered Agent ID.
+The server sends `AP2_API_KEY` as an `Authorization: Bearer` header and `AP2_AGENT_ID` as an `X-Agent-Id` header on every request (`src/index.ts:69-73`).
-### Get your credentials
-
-1. Visit the [AP2 Developer Portal](https://developers.google.com/ap2)
-2. Register your application
-3. Generate an API key
-4. Register your agent to get an Agent ID
-5. Set the environment variables
-
-## Sandbox / Testing
-
-AP2 provides a sandbox environment for testing. Set `AP2_SANDBOX=true` to use it.
+There is no portal issuing those credentials. The developer portal this README used to link, `developers.google.com/ap2`, answers HTTP 404, as does the `ap2-spec` repository it pointed at. The published specification is at [ap2-protocol.org](https://ap2-protocol.org).
## Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
-| `AP2_API_KEY` | Yes | API key from AP2 |
-| `AP2_AGENT_ID` | Yes | Registered agent ID |
-| `AP2_SANDBOX` | No | Set to `true` for sandbox mode |
+| `AP2_API_KEY` | Yes | Sent as `Authorization: Bearer` |
+| `AP2_AGENT_ID` | Yes | Sent as the `X-Agent-Id` header |
+| `AP2_SANDBOX` | No | `true` switches `BASE_URL` to `https://sandbox.ap2.googleapis.com/v1`, which fails TLS |
## Use Cases
@@ -137,8 +127,7 @@ Want to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [r
## Links
-- [AP2 (Google)](https://developers.google.com/ap2)
-- [AP2 Specification](https://github.com/anthropic-payments/ap2-spec)
+- [AP2 specification](https://ap2-protocol.org)
- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)
- [Landing Page](https://codespar.dev/mcp)
diff --git a/packages/payments/ap2/src/index.ts b/packages/payments/ap2/src/index.ts
index d71013c6..169a6622 100644
--- a/packages/payments/ap2/src/index.ts
+++ b/packages/payments/ap2/src/index.ts
@@ -7,13 +7,15 @@
* for AI agents making payments. It defines who authorized a payment,
* what limits apply, and maintains a complete audit trail.
*
- * NO LIVE ENDPOINT: BASE_URL below points at ap2.googleapis.com (and
- * sandbox.ap2.googleapis.com), which is not a registered Google API
- * service. The production host answers the Google frontend's generic
- * "Error 404 (Not Found)" HTML page; the sandbox host fails the TLS
- * handshake because the *.googleapis.com certificate does not cover a
- * fourth label. AP2 is an open specification, not an API served here.
- * The tool schemas below follow the spec; the calls do not land.
+ * NO LIVE ENDPOINT (checked 2026-08-27): ap2.googleapis.com answers HTTP
+ * 404 with Google's generic "Error 404 (Not Found)" HTML page instead of an
+ * API response, while storage.googleapis.com and translate.googleapis.com
+ * each answered a structured JSON API error on the same run.
+ * sandbox.ap2.googleapis.com fails the TLS handshake, because the
+ * certificate served there covers *.googleapis.com and not the extra label.
+ * AP2 is a published specification; these tool definitions have not been
+ * checked against a conforming implementation, and calls made through this
+ * server do not reach a service.
*
* Tools:
* - register_agent: Register an AI agent as a trusted payer in AP2
@@ -40,9 +42,9 @@
* - verify_receipt: Verify a receipt's signature and integrity
*
* Environment:
- * AP2_API_KEY — API key for AP2 platform
- * AP2_AGENT_ID — Registered agent ID
- * AP2_SANDBOX — Set to "true" for sandbox mode
+ * AP2_API_KEY — sent as Authorization: Bearer
+ * AP2_AGENT_ID — sent as the X-Agent-Id header
+ * AP2_SANDBOX — "true" switches BASE_URL to the sandbox host
*/
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -235,7 +237,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
},
{
name: "list_payment_methods",
- description: "List available payment methods from AP2 partner network (Visa, Mastercard, Stripe, PayPal, etc.)",
+ description: "List payment methods offered by the AP2 partner network.",
inputSchema: {
type: "object",
properties: {
diff --git a/packages/payments/stripe-acp/README.md b/packages/payments/stripe-acp/README.md
index 6c123a65..b1ec08f7 100644
--- a/packages/payments/stripe-acp/README.md
+++ b/packages/payments/stripe-acp/README.md
@@ -9,8 +9,6 @@
The **Agentic Commerce Protocol (ACP)** is an open standard co-developed by Stripe and OpenAI. It enables AI agents to complete purchases on behalf of users — the agent handles the checkout UX, while the seller handles inventory, pricing, and payment processing.
-ACP is live in ChatGPT with 1M+ Shopify merchants connected.
-
This MCP server covers both **ACP protocol operations** (checkout sessions, payment delegation) and **standard Stripe API operations** (customers, products, invoices, subscriptions).
## Quick Start
diff --git a/packages/payments/ucp/README.md b/packages/payments/ucp/README.md
index 22493569..9be1a3fb 100644
--- a/packages/payments/ucp/README.md
+++ b/packages/payments/ucp/README.md
@@ -5,7 +5,7 @@
[](https://www.npmjs.com/package/@codespar/mcp-ucp)
[](https://opensource.org/licenses/MIT)
-> **No live endpoint.** This server calls `https://commerce.googleapis.com/ucp/v1` (`BASE_URL`, `src/index.ts:69-71`). That address answers the Google frontend's generic `Error 404 (Not Found)` HTML page, which is what a `*.googleapis.com` name returns when no API service is registered under it; a registered service such as `storage.googleapis.com` answers a structured JSON API error instead. With `UCP_SANDBOX=true` the request does not complete the TLS handshake, because the `*.googleapis.com` certificate does not cover the fourth label in `sandbox.commerce.googleapis.com`. UCP is an open specification; the 20 tool schemas below follow it, but calls made through them fail before reaching any service.
+> **No live endpoint.** Checked on 2026-08-27. This server's `BASE_URL` (`src/index.ts:71-73`) is `https://commerce.googleapis.com/ucp/v1`, which answers HTTP 404 with Google's generic `Error 404 (Not Found)` HTML page instead of an API response. With `UCP_SANDBOX=true` the address becomes `https://sandbox.commerce.googleapis.com/ucp/v1`, which fails the TLS handshake, because the certificate served there covers `*.googleapis.com` and not the extra label. As controls on the same run, `storage.googleapis.com` and `translate.googleapis.com` each answered a structured JSON API error. UCP is a published specification and this package ships tool definitions written for it; we have not checked them against a conforming implementation, and no call made through this server currently reaches a service.
## What is UCP?
@@ -77,9 +77,9 @@ AI Agent
| Variable | Required | Description |
|----------|----------|-------------|
-| `UCP_API_KEY` | Yes | API key for UCP platform |
-| `UCP_MERCHANT_ID` | No | Default merchant ID |
-| `UCP_SANDBOX` | No | Set to `true` for sandbox mode |
+| `UCP_API_KEY` | Yes | Sent as `Authorization: Bearer` |
+| `UCP_MERCHANT_ID` | No | Sent as the `X-Merchant-Id` header |
+| `UCP_SANDBOX` | No | `true` switches `BASE_URL` to `https://sandbox.commerce.googleapis.com/ucp/v1`, which fails TLS |
## Links
@@ -93,11 +93,9 @@ Need governance, budget limits, and audit trails for agent payments? [CodeSpar E
## Authentication
-Set these environment variables before launching the server:
+The server sends `UCP_API_KEY` as an `Authorization: Bearer` header and `UCP_MERCHANT_ID` as an `X-Merchant-Id` header on every request (`src/index.ts:78-83`).
-- `UCP_API_KEY` *(required, secret)* — API key for ucp
-
-Issue credentials at the provider's developer portal: .
+There is no portal issuing those credentials. The developer portal this README used to link, `developers.google.com/agents/commerce`, answers HTTP 404.
## License
diff --git a/packages/payments/ucp/server.json b/packages/payments/ucp/server.json
index bc00591b..46632a74 100644
--- a/packages/payments/ucp/server.json
+++ b/packages/payments/ucp/server.json
@@ -31,7 +31,6 @@
"homepage": "https://www.google.com",
"logoUrl": "https://logo.clearbit.com/google.com",
"logoFallback": "https://www.google.com/s2/favicons?domain=google.com&sz=128",
- "docsUrl": "https://developers.google.com/agents/commerce",
"sandbox": {
"available": false
}
diff --git a/packages/payments/ucp/src/index.ts b/packages/payments/ucp/src/index.ts
index 9605b684..ae62a156 100644
--- a/packages/payments/ucp/src/index.ts
+++ b/packages/payments/ucp/src/index.ts
@@ -42,9 +42,9 @@
* - get_profile: Get buyer profile and preferences
*
* Environment:
- * UCP_API_KEY — API key for UCP platform
- * UCP_MERCHANT_ID — Default merchant ID
- * UCP_SANDBOX — Set to "true" for sandbox mode
+ * UCP_API_KEY — sent as Authorization: Bearer
+ * UCP_MERCHANT_ID — sent as the X-Merchant-Id header
+ * UCP_SANDBOX — "true" switches BASE_URL to the sandbox host
*/
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -56,13 +56,15 @@ import {
ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";
-// NO LIVE ENDPOINT: BASE_URL below points at commerce.googleapis.com (and
-// sandbox.commerce.googleapis.com), which is not a registered Google API
-// service. The production host answers the Google frontend's generic
-// "Error 404 (Not Found)" HTML page; the sandbox host fails the TLS
-// handshake because the *.googleapis.com certificate does not cover a
-// fourth label. UCP is an open specification, not an API served here.
-// The tool schemas below follow the spec; the calls do not land.
+// NO LIVE ENDPOINT (checked 2026-08-27): commerce.googleapis.com answers
+// HTTP 404 with Google's generic "Error 404 (Not Found)" HTML page instead
+// of an API response, while storage.googleapis.com and
+// translate.googleapis.com each answered a structured JSON API error on the
+// same run. sandbox.commerce.googleapis.com fails the TLS handshake, because
+// the certificate served there covers *.googleapis.com and not the extra
+// label. UCP is a published specification; these tool definitions have not
+// been checked against a conforming implementation, and calls made through
+// this server do not reach a service.
const API_KEY = process.env.UCP_API_KEY || "";
const MERCHANT_ID = process.env.UCP_MERCHANT_ID || "";
const SANDBOX = process.env.UCP_SANDBOX === "true";
From 8261e7ec318fd9e27fdc97e5df6cd416f1783257 Mon Sep 17 00:00:00 2001
From: Fabiano Cruz
Date: Thu, 27 Aug 2026 13:42:57 -0300
Subject: [PATCH 3/3] docs(catalogo): tirar a frase de controle, que era falsa
e nao discriminava
A re-revisao reprovou a frase de controle em cinco superficies, e ela estava
errada mesmo. Rodei agora: translate.googleapis.com/v1 devolve o MESMO 404
generico em HTML que ap2.googleapis.com/v1, e storage.googleapis.com/v1
devolve XML (InvalidBucketName), nao "a structured JSON API error". Ou seja
o controle nao distinguia "nome sem servico registrado" de "path errado em
servico registrado", que era exatamente o que ele deveria distinguir.
A conclusao nao dependia dele e continua de pe: todo path que estes
servidores de fato chamam falhou na mesma rodada. O README raiz agora diz
isso, e diz tambem que um 404 generico sozinho nao prova ausencia de
servico.
---
README.md | 2 +-
packages/payments/ap2/README.md | 10 +++++-----
packages/payments/ap2/src/index.ts | 4 +---
packages/payments/ucp/README.md | 2 +-
packages/payments/ucp/src/index.ts | 5 ++---
5 files changed, 10 insertions(+), 13 deletions(-)
diff --git a/README.md b/README.md
index ca8575a8..46464413 100644
--- a/README.md
+++ b/README.md
@@ -72,7 +72,7 @@ Four servers for the emerging agentic payment stack:
> | `@codespar/mcp-ap2` | `https://ap2.googleapis.com/v1` (`packages/payments/ap2/src/index.ts:62-64`) | HTTP 404, the same generic HTML page |
> | `@codespar/mcp-x402` | `https://api.x402.org/v1` (`packages/crypto/x402/src/index.ts:40`) | `NXDOMAIN`, the host does not resolve |
>
-> Controls on the same network and resolvers: `storage.googleapis.com` and `translate.googleapis.com` each answered a structured JSON API error, and `x402.org` itself resolved and answered HTTP 200. The sandbox addresses selected by `UCP_SANDBOX` and `AP2_SANDBOX` fail earlier still, at TLS, because the certificate served there covers `*.googleapis.com` and not the extra label in `sandbox.commerce.googleapis.com` or `sandbox.ap2.googleapis.com`.
+> Every path these servers actually call failed on the same run, which is what the claim above rests on. A generic 404 by itself does not prove a name has no service behind it: `translate.googleapis.com/v1`, a registered service asked for a path it does not serve, answers the same generic page.
>
> UCP, AP2, and x402 are published specifications, and these three packages ship tool definitions written for them. We have not checked those definitions against a conforming implementation, and no call made through the three servers currently reaches a service.
diff --git a/packages/payments/ap2/README.md b/packages/payments/ap2/README.md
index 4d4a395e..e7952c06 100644
--- a/packages/payments/ap2/README.md
+++ b/packages/payments/ap2/README.md
@@ -8,7 +8,7 @@
[](https://www.npmjs.com/package/@codespar/mcp-ap2)
[](https://opensource.org/licenses/MIT)
-> **No live endpoint.** Checked on 2026-08-27. This server's `BASE_URL` (`src/index.ts:62-64`) is `https://ap2.googleapis.com/v1`, which answers HTTP 404 with Google's generic `Error 404 (Not Found)` HTML page instead of an API response. With `AP2_SANDBOX=true` the address becomes `https://sandbox.ap2.googleapis.com/v1`, which fails the TLS handshake, because the certificate served there covers `*.googleapis.com` and not the extra label. As controls on the same run, `storage.googleapis.com` and `translate.googleapis.com` each answered a structured JSON API error. AP2 is a published specification and this package ships tool definitions written for it; we have not checked them against a conforming implementation, and no call made through this server currently reaches a service.
+> **No live endpoint.** Checked on 2026-08-27. This server's `BASE_URL` (`src/index.ts:62-64`) is `https://ap2.googleapis.com/v1`, which answers HTTP 404 with Google's generic `Error 404 (Not Found)` HTML page instead of an API response. With `AP2_SANDBOX=true` the address becomes `https://sandbox.ap2.googleapis.com/v1`, which fails the TLS handshake, because the certificate served there covers `*.googleapis.com` and not the extra label. AP2 is a published specification and this package ships tool definitions written for it; we have not checked them against a conforming implementation, and no call made through this server currently reaches a service.
## What is AP2?
@@ -74,19 +74,19 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
| `get_authorization` | Get authorization details including status, limits, and expiry |
| `list_authorizations` | List payment authorizations with optional filters |
| `execute_payment` | Execute an authorized payment. |
-| `get_audit_trail` | Get the complete audit trail for a transaction — every authorization, approval, execution, and settlement e... |
+| `get_audit_trail` | Get the complete audit trail for a transaction — every authorization, approval, execution, and settlement e.. |
| `list_audit_events` | List audit events across all transactions with filters |
| `list_payment_methods` | List payment methods offered by the AP2 partner network |
| `get_transaction` | Get full transaction details including authorization, execution, and settlement status |
| `list_transactions` | List transactions with optional filters |
-| `create_intent_mandate` | Create an AP2 intent mandate — a Verifiable Credential expressing the user's intent to delegate a transacti... |
-| `create_cart_mandate` | Create an AP2 cart mandate — a signed, locked-cart commitment from a merchant binding line items, totals, a... |
+| `create_intent_mandate` | Create an AP2 intent mandate — a Verifiable Credential expressing the user's intent to delegate a transacti.. |
+| `create_cart_mandate` | Create an AP2 cart mandate — a signed, locked-cart commitment from a merchant binding line items, totals, a.. |
| `create_payment_mandate` | Create an AP2 payment mandate — the final Verifiable Credential authorizing settlement against a cart mandate. |
| `verify_credential` | Verify a Verifiable Credential (intent, cart, or payment mandate). |
| `create_presentation` | Create a Verifiable Presentation bundling one or more credentials (e.g. |
| `verify_presentation` | Verify a Verifiable Presentation and all embedded credentials, including holder binding and challenge nonce. |
| `resolve_did` | Resolve a Decentralized Identifier (DID) to its DID document via the AP2 universal resolver. |
-| `create_receipt` | Create a signed receipt for a settled payment — a tamper-evident record linking transaction, mandates, and... |
+| `create_receipt` | Create a signed receipt for a settled payment — a tamper-evident record linking transaction, mandates, and.. |
| `verify_receipt` | Verify a receipt's signature, issuer, and chain back to the originating mandates. |
## Authentication
diff --git a/packages/payments/ap2/src/index.ts b/packages/payments/ap2/src/index.ts
index 169a6622..31ee058a 100644
--- a/packages/payments/ap2/src/index.ts
+++ b/packages/payments/ap2/src/index.ts
@@ -9,9 +9,7 @@
*
* NO LIVE ENDPOINT (checked 2026-08-27): ap2.googleapis.com answers HTTP
* 404 with Google's generic "Error 404 (Not Found)" HTML page instead of an
- * API response, while storage.googleapis.com and translate.googleapis.com
- * each answered a structured JSON API error on the same run.
- * sandbox.ap2.googleapis.com fails the TLS handshake, because the
+ * API response. sandbox.ap2.googleapis.com fails the TLS handshake, because the
* certificate served there covers *.googleapis.com and not the extra label.
* AP2 is a published specification; these tool definitions have not been
* checked against a conforming implementation, and calls made through this
diff --git a/packages/payments/ucp/README.md b/packages/payments/ucp/README.md
index 9be1a3fb..f17f988a 100644
--- a/packages/payments/ucp/README.md
+++ b/packages/payments/ucp/README.md
@@ -5,7 +5,7 @@
[](https://www.npmjs.com/package/@codespar/mcp-ucp)
[](https://opensource.org/licenses/MIT)
-> **No live endpoint.** Checked on 2026-08-27. This server's `BASE_URL` (`src/index.ts:71-73`) is `https://commerce.googleapis.com/ucp/v1`, which answers HTTP 404 with Google's generic `Error 404 (Not Found)` HTML page instead of an API response. With `UCP_SANDBOX=true` the address becomes `https://sandbox.commerce.googleapis.com/ucp/v1`, which fails the TLS handshake, because the certificate served there covers `*.googleapis.com` and not the extra label. As controls on the same run, `storage.googleapis.com` and `translate.googleapis.com` each answered a structured JSON API error. UCP is a published specification and this package ships tool definitions written for it; we have not checked them against a conforming implementation, and no call made through this server currently reaches a service.
+> **No live endpoint.** Checked on 2026-08-27. This server's `BASE_URL` (`src/index.ts:71-73`) is `https://commerce.googleapis.com/ucp/v1`, which answers HTTP 404 with Google's generic `Error 404 (Not Found)` HTML page instead of an API response. With `UCP_SANDBOX=true` the address becomes `https://sandbox.commerce.googleapis.com/ucp/v1`, which fails the TLS handshake, because the certificate served there covers `*.googleapis.com` and not the extra label. UCP is a published specification and this package ships tool definitions written for it; we have not checked them against a conforming implementation, and no call made through this server currently reaches a service.
## What is UCP?
diff --git a/packages/payments/ucp/src/index.ts b/packages/payments/ucp/src/index.ts
index ae62a156..086900e0 100644
--- a/packages/payments/ucp/src/index.ts
+++ b/packages/payments/ucp/src/index.ts
@@ -58,9 +58,8 @@ import {
// NO LIVE ENDPOINT (checked 2026-08-27): commerce.googleapis.com answers
// HTTP 404 with Google's generic "Error 404 (Not Found)" HTML page instead
-// of an API response, while storage.googleapis.com and
-// translate.googleapis.com each answered a structured JSON API error on the
-// same run. sandbox.commerce.googleapis.com fails the TLS handshake, because
+// of an API response. sandbox.commerce.googleapis.com fails the TLS
+// handshake, because
// the certificate served there covers *.googleapis.com and not the extra
// label. UCP is a published specification; these tool definitions have not
// been checked against a conforming implementation, and calls made through