Demo

This page provides ready-to-use prompts you can paste directly into Claude Desktop (or any MCP client) to demonstrate the full system. Each prompt exercises a specific capability — from wallet management to autonomous x402 payments.

Before you start: Complete the Quickstart to have the MCP server running and at least one funded wallet available.

Two-Agent Network Demo

The flagship demonstration: deploy the Merchant API on one machine and connect an AI Buyer from a separate client. This proves true machine-to-machine commerce over a network.

Network Requirement: The Merchant’s localhost:3000 must be reachable by the Buyer. Options:

Two machines on the same Wi-Fi
A tunneling service like Cloudflared
Deploy the Merchant to a cloud provider (Render, Railway, etc.)

Setting Up the Merchant

Clone & Build

git clone https://github.com/xavierScript/agent-economy-wallet.git
cd agent-economy-wallet
pnpm install && pnpm build

Configure Environment

.env

WALLET_PASSPHRASE="your_secure_passphrase"
MERCHANT_RECEIVER_ADDRESS="Your_Solana_Public_Key_Here"

Start & Expose

node packages/mcp-server/dist/index.js

If the Buyer is on a different network, expose port 3000:

cloudflared tunnel --url http://localhost:3000

Copy the resulting URL — you’ll use it in the prompts below.

Setting Up the AI Buyer

Fund the Agent

Ensure the Buyer’s wallet has Devnet SOL (for gas) and Devnet USDC to pay invoices.

Connect MCP Client

Point Claude Desktop at your local build:

{
  "mcpServers": {
    "agent-economy-wallet": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"]
    }
  }
}

Restart

Restart Claude/Cursor to load the wallet and payment tools.

Two-Agent Prompts

Replace <MERCHANT_URL> with your Cloudflared URL or local IP. Scenario A — Buy Token Pricing Data:

“There is an external data provider running at <MERCHANT_URL>/api/fetch-price/SOL. Please send a GET request to that endpoint to securely get the Solana price. If the API returns a 402 Payment Required response, parse the invoice details from the error response. Use your pay_x402 tool to fulfill the invoice payment of Devnet USDC to the provided merchant address, and obtain the transaction signature. Once paid, immediately retry your HTTP request appending the signature in the x-receipt-signature header, and tell me the price.”

Scenario B — Buy a Security Rug-Check:

“There is an external data provider running at <MERCHANT_URL>/api/analyze-token/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Please send a GET request to that endpoint to perform a security assessment on this token. If the API returns a 402 Payment Required response, parse the invoice details from the error response. Use your pay_x402 tool to fulfill the invoice payment of Devnet USDC to the provided merchant address, and obtain the transaction signature. Once paid, immediately retry your HTTP request appending the signature in the x-receipt-signature header, and summarize the security assessment.”

Full Capability Demo Prompts

Beyond x402 payments, the system is a fully-featured on-chain infrastructure. Below are 22 prompts that cover every capability.

Replace [WALLET_ID], [RECIPIENT_ADDRESS], and [MINT_ADDRESS] with actual values from your agent.

System & Wallet Management

1. System Health Check

Check the current system status of the Agentic Wallet MCP server and report: Which Solana cluster is active, whether a master funding wallet is configured, how many agent wallets are registered, and the full system configuration.

2. Create a Funded Agent Wallet

Create a new agent wallet with the label “demo-agent” and report: The wallet ID and public key, whether it was automatically funded from the master wallet (and amount), the Solana Explorer link, and confirmation that a spending policy was attached.

3. List All Managed Wallets

List all wallets currently managed by this system. For each wallet, display its ID, label, public key, current SOL balance, and creation date.

4. Inspect a Wallet Balance

Retrieve the full balance breakdown for wallet [WALLET_ID]. Include the SOL balance and every SPL token the wallet holds, with mint addresses and human-readable amounts.

5. Inspect Wallet Policy and Usage

Read the full details and active spending policy for wallet [WALLET_ID] and display: The per-transaction SOL limit, the hourly transaction rate limit, the daily SOL spending cap, and how many of today’s allowances have been consumed.

On-Chain Execution & Guardrails

6. Send SOL

Send 0.01 SOL from wallet [WALLET_ID] to address [RECIPIENT_ADDRESS]. Return the transaction signature and Solana Explorer link for verification.

7. Guardrail Enforcement — Blocked by Policy

Attempt to send 5 SOL from wallet [WALLET_ID] to address [RECIPIENT_ADDRESS]. The wallet’s policy enforces a 2 SOL per-transaction limit. Demonstrate whether the transaction is blocked before it reaches the network and what error is returned.

8. Write an On-Chain Memo

Write the following memo on-chain using wallet [WALLET_ID]: “Agentic Wallet — autonomous on-chain action verified”. Return the transaction signature and Solana Explorer link.

9. Create an SPL Token Mint

Using wallet [WALLET_ID], create a new SPL token mint with 9 decimal places. The wallet should be set as the mint authority. Return the mint address.

10. Mint Tokens

Mint 1,000,000 tokens from mint [MINT_ADDRESS] into wallet [WALLET_ID]. Retrieve the updated balance afterward and confirm the tokens were received.

11. Transfer SPL Tokens

Transfer 100 tokens of mint [MINT_ADDRESS] from wallet [WALLET_ID] to address [RECIPIENT_ADDRESS], using 9 decimals. Return the transaction signature.

Discovery & Marketplace

12. Discover Registered Merchants

Query the on-chain agent registry to discover all registered merchants. For each merchant, display its name, manifest URL, wallet address, and registration timestamp.

13. Read a Merchant Manifest

Read the service manifest from a discovered merchant. Display all available services, their pricing, the accepted payment token, and the merchant’s description.

14. Check Merchant Reputation

Check the reputation of a merchant at their /reputation endpoint. Report their success rate, total transactions, and overall trust score.

Auditing & Reporting

15. Global Audit Log

Retrieve the 20 most recent entries from the global audit log. For each entry, display the timestamp, action type, wallet ID, and outcome. Highlight any policy violations or blocked transactions.

16. Per-Wallet Audit History

Read the full audit history for wallet [WALLET_ID]. List every action it has taken — SOL transfers, policy checks, failed attempts, and the initial auto-funding event.

17. Security Audit (MCP Prompt)

Run a full security audit of this Agentic Wallet deployment using the security_audit prompt. Cover policy violations, unusual transaction patterns, blocked transactions, and an overall security posture assessment.

18. Daily Operations Report (MCP Prompt)

Generate a full daily operations report using the daily_report prompt. Include total transactions, total SOL moved, blocked policy violations, and any anomalies requiring operator review.

19. Risk Assessment (MCP Prompt)

Run a risk assessment on wallet [WALLET_ID] using the risk_assessment prompt. Evaluate current balances against active policy limits, calculate remaining daily headroom, and recommend adjustments.

Data & x402 Payments

20. Probe an x402 Resource

Check whether http://localhost:3000/api/analyze-token/SOL requires x402 payment. If a payment is required, report the price, accepted payment token, and target network. Do not submit any payment at this stage.

21. Autonomous x402 Payment

Access http://localhost:3000/api/analyze-token/SOL using wallet [WALLET_ID]. Handle the full x402 payment flow autonomously — discover the price, execute the payment, and return the resource content along with the payment transaction signature.

22. Fetch Live Token Prices

Fetch the current USD prices for SOL, USDC, USDT, BONK, and JUP using the fetch_prices tool. Report each token’s price and the data source.

Gasless Kora Integration

The following prompts require a running Kora node. If Kora is not configured, these will fall back to standard (gas-paying) transactions.

23. Gasless SOL Transfer via Kora

Send 0.005 SOL from wallet [WALLET_ID] to address [RECIPIENT_ADDRESS]. This transfer should be gasless via the Kora paymaster node. Confirm the transaction landed and report: The signature, whether the agent wallet’s SOL balance decreased by exactly 0.005 SOL (proving it did not pay gas), and the audit log entry showing gasless: true.

24. Gasless On-Chain Memo via Kora

Write the following memo on-chain using wallet [WALLET_ID]: “Gasless memo — Kora paymaster sponsoring network fees”. Confirm the transaction was gasless (agent paid no SOL for gas) and return the transaction signature.

25. Verify Kora Gasless Audit Trail

Retrieve the most recent audit log entries for wallet [WALLET_ID]. Identify all entries where gasless is true and feePayer is “kora”. Summarize the total SOL moved gaslessly vs self-paid.

Quick Reference

#	Capability	MCP Tool / Resource	What it proves
1	System health	`get_status`, `system://status`	Server liveness, resource layer
2	Create funded wallet	`create_wallet`	Auto-funding, policy-at-creation
3	List wallets	`list_wallets`, `wallet://all-wallets`	Multi-wallet management
4	Inspect balance	`get_balance`	SOL + SPL multi-asset balances
5	Wallet policy	`get_policy`, `wallet://policy`	Policy visibility, live counters
6	Send SOL	`send_sol`	Policy-enforced transfer
7	Blocked by guardrail	`send_sol` (rejected)	Hard enforcement — no override
8	On-chain memo	`write_memo`	SPL Memo, immutable provenance
9	Create token mint	`create_token_mint`	Agent-controlled mint authority
10	Mint tokens	`mint_tokens`	SPL token supply issuance
11	Transfer SPL tokens	`send_token`	SPL transfer, ATA handling
12	Discover merchants	`discover_registry`	On-chain registry scan
13	Read manifest	`read_manifest`	Service + pricing discovery
14	Check reputation	`check_reputation`	Trust evaluation
15	Global audit log	`get_audit_logs`, `audit://logs`	Cross-wallet audit trail
16	Per-wallet audit	`audit://wallet-logs`	Scoped wallet history
17	Security audit	`security_audit` prompt	Compliance review
18	Daily report	`daily_report` prompt	Operator reporting
19	Risk assessment	`risk_assessment` prompt	Exposure analysis
20	Probe x402	`probe_x402`	Cost discovery without payment
21	Pay x402	`pay_x402_invoice`	Autonomous micropayment loop
22	Fetch prices	`fetch_prices`	Jupiter Price API
23	Gasless SOL transfer	`send_sol` + Kora	Kora pays gas
24	Gasless memo	`write_memo` + Kora	Any tx is gasless with Kora
25	Gasless audit trail	`audit://wallet-logs`	Forensic gasless vs self-paid

Getting Started

SDK

MCP Tools

MCP Resources

MCP Prompts

API Reference

Infrastructure

Security

Two-Agent Network Demo

Setting Up the Merchant

Setting Up the AI Buyer

Two-Agent Prompts

Full Capability Demo Prompts

System & Wallet Management

On-Chain Execution & Guardrails

Discovery & Marketplace

Auditing & Reporting

Data & x402 Payments

Gasless Kora Integration

Quick Reference

Getting Started

SDK

MCP Tools

MCP Resources

MCP Prompts

API Reference

Infrastructure

Security

​Two-Agent Network Demo

​Setting Up the Merchant

​Setting Up the AI Buyer

​Two-Agent Prompts

​Full Capability Demo Prompts

​System & Wallet Management

​On-Chain Execution & Guardrails

​Discovery & Marketplace

​Auditing & Reporting

​Data & x402 Payments

​Gasless Kora Integration

​Quick Reference

Two-Agent Network Demo

Setting Up the Merchant

Setting Up the AI Buyer

Two-Agent Prompts

Full Capability Demo Prompts

System & Wallet Management

On-Chain Execution & Guardrails

Discovery & Marketplace

Auditing & Reporting

Data & x402 Payments

Gasless Kora Integration

Quick Reference