BlinkCodes-Agent-Schnittstellen

Maschinenlesbare Schnittstellen für blinkcodes.com – einen Shop, der Geschenkkartencodes, Service-Aufladungen und Reise-eSIMs verkauft, mit Lieferung per E-Mail in Sekunden.

Alles hier ist ein entfernter, gehosteter Dienst. Es gibt nichts zu installieren und keinen Server zu betreiben: Richten Sie Ihren Client auf die untenstehenden URLs. Dieses Repository dient dazu, diese Endpunkte zu dokumentieren, ihre Schemata festzulegen und funktionierende Beispiele zu geben.

Discovery-Dokumente: /.well-known/agent-card.json, /.well-known/mcp/server-card.json, /.well-known/api-catalog, /.well-known/agent-skills/index.json, /.well-known/acp.json, /.well-known/ucp.

MCP-Server

Veröffentlicht im Official MCP Registry als com.blinkcodes/catalog (server.json).

Drei Tools. Die beiden Katalog-Tools sind schreibgeschützt und kostenlos – kein Schlüssel, kein Konto, keine Zahlung. Das dritte kostet Geld, und nur über x402:

buy_product nutzt dieselbe Schiene wie POST /api/v1/buy unten – verifizieren, reservieren, abrechnen, erfüllen, in dieser Reihenfolge – sodass ein Agent, der den Shop über MCP gefunden hat, das Protokoll für den Kauf nicht wechseln muss. Beim ersten Aufruf wird nichts berechnet, und für die anderen beiden Tools wird keine Wallet benötigt.

Fügen Sie es einem Client hinzu, der Remote-MCP spricht:

{
  "mcpServers": {
    "blinkcodes": {
      "type": "http",
      "url": "https://blinkcodes.com/mcp"
    }
  }
}

Vollständige Tool-Schemata und ein curl-Transkript: docs/mcp.md.

Ein reiner stdio-Client kann die Brücke im Dockerfile verwenden, die auf denselben gehosteten Endpunkt weiterleitet:

docker build -t blinkcodes-mcp . && docker run -i --rm blinkcodes-mcp

Bevorzugen Sie die direkte URL oben, wo immer Ihr Client Remote-MCP spricht – die Brücke fügt einen Hop hinzu und kauft nichts.

Related MCP server: the402-mcp-server

Kaufen, für Agenten

Die Zahlung erfolgt in USDC auf Base über x402. Ein Endpunkt, zwei Durchläufe:

1. POST /api/v1/buy mit dem Bestellkörper → 402 mit Zahlungsanforderungen, die für diesen genauen Artikel bepreist sind, plus einem order-Block (id, Zugriffstoken, Status-URL).

2. Die identische Anfrage mit einem PAYMENT-SIGNATURE-Header → 200 mit dem Code, oder 202 + status_url, wenn die Erfüllung das Synchronisationsfenster überschreitet.

// the body, in both passes
{
  "email": "buyer@example.com",
  "product_type": "giftcard",   // giftcard | topup | esim | phone_rental
  "product_id": 187,
  "item_id": 1195,
  "quantity": 1
}

• Netzwerk eip155:8453, Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC).

• x402 standardmäßig v2; v1-Clients senden X-PAYMENT oder fragen mit X-PAYMENT-VERSION: 1 nach einem v1-Angebot.

• GET /api/v1 beschreibt die Schiene kostenlos.

• Ein Aufruf von /api/v1/buy mit nichts benannt antwortet mit 402 und nennt die Untergrenze der Schiene und erstellt keine Bestellung – das ist die Sondenform, sicher für Crawler.

Ausgearbeitetes Beispiel: examples/x402-buy.mjs. Schienen, Untergrenzen und zahlbare Münzpaare: GET /api/public/payment-methods.

A2A

Agent-Karte unter /.well-known/agent-card.json, JSON-RPC message/send unter https://blinkcodes.com/a2a. Die Fähigkeiten sind die beiden Katalog-Tools plus buy_product, das über diesen Transport die a2a-x402 Zahlungserweiterung trägt (https://github.com/google-a2a/a2a-x402/v0.1, deklariert als required: false, weil die Katalog-Fähigkeiten kostenlos sind).

Angebot → Task in input-required mit x402.payment.required; zahlen → gleiche taskId mit x402.payment.payload → Task completed plus die Lieferung als Artefakt. Siehe examples/a2a.sh.

Menschliche Dokumentation

Shop, Preise und Bedingungen: https://blinkcodes.com. Support: support@blinkcodes.com.

Lizenz

MIT – gilt für die Dokumentation und Beispiele in diesem Repository. Der Dienst selbst unterliegt den auf der Website veröffentlichten Bedingungen.