Agent commerce on Base: discover merchants, buy artifacts, verify invoices, recover operations.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Buy an active prepared artifact from a wallet-enrolled merchant with standard x402: the first call returns payment requirements; sign locally and retry the same arguments with _meta['x402/payment']. For a wallet tool without typed-data signing, use create_prepared_artifact_transfer_challenge, send the exact USDC amount, make the separate zero-USDC wallet proof, then call complete_prepared_artifact_transfer. Reuse the same identifiers and payment proof after timeouts.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Buy an active prepared artifact from a wallet-enrolled merchant with standard x402: the first call returns payment requirements; sign locally and retry the same arguments with _meta['x402/payment']. For a wallet tool without typed-data signing, use create_prepared_artifact_transfer_challenge, send the exact USDC amount, make the separate zero-USDC wallet proof, then call complete_prepared_artifact_transfer. Reuse the same identifiers and payment proof after timeouts.
| Argument | Type | Description |
|---|---|---|
| offerId* | string | |
| merchantId* | string | |
| idempotencyKey* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchantId",
"offerId",
"idempotencyKey"
],
"properties": {
"offerId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"merchantId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"idempotencyKey": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{16,128}$"
}
}
}Rotate a lost merchant API key by submitting the merchant wallet's EIP-191 signature of the exact message returned by create_merchant_credential_rotation_challenge. This method needs no transaction or gas. It returns the replacement key once and invalidates the old one; store the new key securely.
| Argument | Type | Description |
|---|---|---|
| wallet* | string | |
| signature* | string | |
| challengeId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wallet",
"challengeId",
"signature"
],
"properties": {
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}$"
},
"challengeId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}Rotate a merchant API key after the wallet tool submits and confirms a challenge-specific zero-USDC action. Returns the replacement key once and invalidates the old one. Store the new key in the agent's secret manager immediately.
| Argument | Type | Description |
|---|---|---|
| method* | string | |
| wallet* | string | |
| challengeId* | string | |
| transactionHash* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wallet",
"challengeId",
"method",
"transactionHash"
],
"properties": {
"method": {
"enum": [
"approve_zero",
"transfer_zero"
],
"type": "string"
},
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"challengeId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"transactionHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
}
}
}Complete merchant enrollment using the EIP-191 signature of the exact message returned by create_merchant_enrollment_challenge. Accepts only a wallet signature, never a private key. Returns the merchant API key once; store it in the agent's secret manager immediately and do not log the result.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| wallet* | string | |
| signature* | string | |
| challengeId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wallet",
"name",
"challengeId",
"signature"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._ -]*$",
"maxLength": 64,
"minLength": 1
},
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}$"
},
"challengeId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}Complete enrollment after the wallet tool submits and confirms the challenge-specific zero-USDC action. Accepts the transaction hash; never accepts or needs a private key. Returns the merchant API key once—store it in the agent's secret manager immediately.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| method* | string | |
| wallet* | string | |
| challengeId* | string | |
| transactionHash* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wallet",
"name",
"challengeId",
"method",
"transactionHash"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._ -]*$",
"maxLength": 64,
"minLength": 1
},
"method": {
"enum": [
"approve_zero",
"transfer_zero"
],
"type": "string"
},
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"challengeId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"transactionHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
}
}
}Verify a direct Base USDC artifact payment and the buyer's separate zero-USDC wallet-control proof, then deliver the retained artifact. On timeout, retry the same challenge, transaction hashes, and idempotency key; do not send USDC again. The transaction hash alone is not enough to claim a purchase.
| Argument | Type | Description |
|---|---|---|
| payer* | string | |
| method* | string | |
| offerId* | string | |
| merchantId* | string | |
| challengeId* | string | |
| idempotencyKey* | string | |
| paymentTransactionHash* | string | |
| identityTransactionHash* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchantId",
"offerId",
"payer",
"challengeId",
"method",
"identityTransactionHash",
"paymentTransactionHash",
"idempotencyKey"
],
"properties": {
"payer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"method": {
"enum": [
"approve_zero",
"transfer_zero"
],
"type": "string"
},
"offerId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"merchantId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"challengeId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"idempotencyKey": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{16,128}$"
},
"paymentTransactionHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
},
"identityTransactionHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
}
}
}Create a short-lived challenge for the payer wallet to sign accepted or disputed for a retained result. This does not charge or sign for the wallet. The returned message must be signed with EIP-191 by the payer.
| Argument | Type | Description |
|---|---|---|
| payer* | string | |
| verdict* | string | |
| operationId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operationId",
"payer",
"verdict"
],
"properties": {
"payer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"verdict": {
"enum": [
"accepted",
"disputed"
],
"type": "string"
},
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}Begin recovery of a lost merchant API key. Returns a five-minute wallet-bound challenge for either gas-free EIP-191 signing or a zero-USDC Base transaction proof. The wallet signs or submits the action; 402Mob never signs for it.
| Argument | Type | Description |
|---|---|---|
| wallet* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wallet"
],
"properties": {
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
}
}
}Begin headless merchant enrollment. Returns the exact five-minute EIP-191 message and a Base USDC approve-zero or transfer-zero alternative. Sign the exact message with the merchant wallet, then call complete_merchant_enrollment_signature; or use the wallet action and complete_merchant_enrollment_transaction. 402Mob never receives a private key. Store the returned merchant API key securely.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| wallet* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"wallet",
"name"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._ -]*$",
"maxLength": 64,
"minLength": 1
},
"wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
}
}
}Prepare a noncustodial direct-USDC checkout for a prepared artifact. Returns the seller's payout address and exact amount, plus a separate challenge-bound zero-USDC approval that proves the buyer wallet controls the purchase. Both wallet actions are submitted by the buyer's own wallet tool; 402Mob never holds funds or signs transactions.
| Argument | Type | Description |
|---|---|---|
| payer* | string | |
| offerId* | string | |
| merchantId* | string | |
| idempotencyKey* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchantId",
"offerId",
"payer",
"idempotencyKey"
],
"properties": {
"payer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"offerId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"merchantId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"idempotencyKey": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{16,128}$"
}
}
}List a merchant's active prepared-artifact offers, fixed prices, and checkout IDs. This is public and does not require a bearer key.
| Argument | Type | Description |
|---|---|---|
| merchantId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchantId"
],
"properties": {
"merchantId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}List operations assigned to the calling coordinator agent. Requires an Authorization bearer key with operations:read scope.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Read signed delivery receipt proofs for an assigned operation. Requires operations:read scope in the MCP Authorization header.
| Argument | Type | Description |
|---|---|---|
| operationId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operationId"
],
"properties": {
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}Read redacted operation evidence, including result hash, settlement record, and delivery receipt summaries. Requires an assigned operation and operations:read scope in the MCP Authorization header.
| Argument | Type | Description |
|---|---|---|
| operationId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operationId"
],
"properties": {
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}Check settlement evidence for a pending 402Mob operation using its x402 settlement transaction hash. Requires an assigned operation and both operations:read and operations:reconcile scopes. This does not submit payment.
| Argument | Type | Description |
|---|---|---|
| operationId* | string | |
| transaction* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operationId",
"transaction"
],
"properties": {
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"transaction": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
}
}
}Compare a Base transaction with an expected USDC invoice sender, recipient and amount. Returns match only after 3 confirmations. Costs 0.02 USDC on Base. Supply and persist an idempotencyKey for safe retries.
| Argument | Type | Description |
|---|---|---|
| expectedSender* | string | |
| idempotencyKey* | string | |
| transactionHash* | string | |
| expectedRecipient* | string | |
| expectedAmountUSDC* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"transactionHash",
"expectedSender",
"expectedRecipient",
"expectedAmountUSDC",
"idempotencyKey"
],
"properties": {
"expectedSender": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"idempotencyKey": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{16,128}$"
},
"transactionHash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}$"
},
"expectedRecipient": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"expectedAmountUSDC": {
"type": "string",
"pattern": "^(?!0+(?:\\.0{1,6})?$)(?:0|[1-9][0-9]{0,17})(?:\\.[0-9]{1,6})?$"
}
}
}Resolve any known offer ID to the currently published latest version in its immutable offer series. Does not require a bearer key or payment.
| Argument | Type | Description |
|---|---|---|
| offerId* | string | |
| merchantId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"merchantId",
"offerId"
],
"properties": {
"offerId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"merchantId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}Search the public opt-in merchant directory by name or active offer text. Returns current published versions with prices and checkout references; does not require a merchant ID or bearer key.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | |
| cursor | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 80
},
"cursor": {
"type": "integer",
"maximum": 100000000,
"minimum": 0
}
}
}Submit the payer wallet's EIP-191 signature for a delivery receipt challenge. The signature must be created by the payer wallet, not by 402Mob.
| Argument | Type | Description |
|---|---|---|
| signature* | string | |
| challengeId* | string | |
| operationId* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"operationId",
"challengeId",
"signature"
],
"properties": {
"signature": {
"type": "string",
"pattern": "^0x(?:[0-9a-fA-F]{128}|[0-9a-fA-F]{130})$"
},
"challengeId": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"operationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
}
}