Skip to content

Open Base Receipt to agents through MCP - #2

Merged
Mabolla merged 1 commit into
mainfrom
feat/agent-receipts
Oct 1, 2026
Merged

Mabolla merged 1 commit into
mainfrom
feat/agent-receipts

Conversation

@Mabolla

@Mabolla Mabolla commented Oct 1, 2026

Copy link
Copy Markdown
Owner

Base Receipt already prepares signed payment orders and verifies direct Base USDC transfers, but agents had no discoverable interface. This PR exposes the existing handlers through stateless MCP at /mcp.

Behavior

  • prepare_base_payment returns a signed 15-minute order and unsigned, attributed USDC transfer data. Wallet signing and submission stay with the caller.
  • issue_base_receipt delegates to the existing settlement verifier and exclusive receipt-claim store. Existing failures remain tool errors; receipt issuance is correctly marked as a write.
  • /agents provides mobile-friendly integration instructions and /api/agent exposes capabilities. The existing wallet payment page links to the integration.
  • No changes to the existing order or verification handlers, no wallet-key access and no transaction submission.
  • Add the dependency lockfile and use npm ci for repeatable CI. Include Next's generated TypeScript configuration updates.

Verification

  • Lint and typecheck passed.
  • 16 tests passed, including the 7 existing tests and 9 MCP tests.
  • Production build passed.
  • Real local production-server check passed through the official SDK: discovery, unsigned transfer amount/recipient/attribution, invalid-signature rejection, existing homepage and new documentation routes.
  • scripts/check-agent.mjs provides the same no-payment release check for a deployment.

Deployment

Use the existing GitHub-to-Vercel integration. Confirm public MCP access after merging; no live MCP claim is made by this PR alone. No mainnet transaction or durable receipt was created during testing.

@vercel

vercel Bot commented Oct 1, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
base-receipt Ready Ready Preview Oct 1, 2026 4:39pm UTC

@Mabolla
Mabolla merged commit c686f6e into main Oct 1, 2026
3 checks passed

This branch was successfully deployed

1 active deployment
Preview — a9a07c50 Deployed Oct 1, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant