Use indie.money with AI Assistants

Use indie.money with AI Assistants

indie.money is a marketplace for automation services powered by blockchain. Builders publish n8n workflows as services, and anyone can purchase, own (as an NFT), and run them — paying per execution in stablecoin.

indie.money supports the Model Context Protocol (MCP) — an open standard that lets AI assistants like Claude, ChatGPT, Cursor, and others connect directly to indie.money.

Think of it like giving your AI assistant a set of tools: it can browse the marketplace, create wallets, purchase services, and execute workflows — all through natural conversation.

Quick Start

1. Connect your AI assistant

indie.money is currently in testnet (Base Sepolia, chain 84532). Everything is free to try — test tokens have no real value.

Add indie.money as an MCP server in your AI assistant's settings:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{  "mcpServers": {    "indie-money": {      "url": "https://executor-staging.indie.money/mcp"    }  }}

Claude Code (.claude/settings.json):

{  "mcpServers": {    "indie-money": {      "url": "https://executor-staging.indie.money/mcp"    }  }}

2. Create a wallet

"Create a wallet on indie.money"

You'll receive a wallet key (wk_...) and an address. Save the wallet key — it's the only way to access your wallet and funds. There is no recovery if lost.

3. Get test tokens

"Get test tokens for my wallet wk_abc123 on chain 84532"

This adds 1,000 free test USDC to your wallet ($1,000 worth — no real value on testnet).

4. Swap to InUSD

Services are priced in InUSD (indie.money's platform token). Swap some test USDC first:

"Swap $500 worth of USDC to InUSD for wallet wk_abc123 on chain 84532"

(That's 500000000 in microtokens — see Understanding Amounts below.)

5. Browse and use services

"Browse the indie.money marketplace on chain 84532"

"Purchase service 0x1234... with my wallet wk_abc123 on chain 84532"

Your AI assistant handles all the payment and blockchain details automatically.

Understanding Amounts

All amounts in indie.money are in microtokens (6 decimal places), similar to how Ethereum uses wei:

Tip: Tell your AI assistant the dollar amount and let it calculate the microtokens for you:

"Swap $10 worth of USDC to InUSD for wallet wk_abc123 on chain 84532"

Specifying the Chain

Most commands need a chain ID to know which blockchain network to use. Always include it:

On testnet, always say "on chain 84532" in your requests.

Commands that don't need a chain ID: create-wallet, get-address, delete-wallet, execute-service (webhooks already know their chain).

Wallet Management

Your wallet lives on indie.money's platform. You interact with it using a wallet key — a short ID that starts with wk_.

Important: Your wallet key is the only way to access your funds. If you lose it, your wallet and all tokens in it are permanently gone. indie.money cannot recover lost wallet keys.

Checking balances

"Check the balance of wallet wk_abc123 on chain 84532"

You can also check the balance of a specific token by providing its contract address:

"Check the balance of token 0x7a00... for wallet wk_abc123 on chain 84532"

Getting test tokens

On testnet (chain 84532), you can request free tokens:

"Get test tokens for wallet wk_abc123 on chain 84532"

Swapping tokens

indie.money uses two tokens: USDC (the stablecoin you deposit) and InUSD (the platform token used for payments). You need InUSD to purchase and execute services.

"Swap $100 of USDC to InUSD for wallet wk_abc123 on chain 84532"

"Swap $50 of InUSD back to USDC for wallet wk_abc123 on chain 84532"

To check the exchange rate:

"Get a swap quote for $10 USDC to InUSD on chain 84532"

Discovering Services

Browse and explore services available on the marketplace.

Using Services

The typical flow to use a service:

1. Purchase

"Purchase service 0x1234... with wallet wk_abc123 on chain 84532"

This mints an NFT that represents your ownership of this service instance. The purchase price is deducted from your InUSD balance automatically.

2. Set up credentials (if needed)

Some services require API keys or OAuth connections (e.g., OpenAI, Slack, Google):

"What credentials does service 0x1234... token 1 need on chain 84532?"

"Submit API key for service 0x1234... with wallet wk_abc123 on chain 84532"

3. Activate

"Activate service 0x1234... token 1 with wallet wk_abc123 on chain 84532"

4. Register a webhook

"Register a webhook for service 0x1234... token 1 with wallet wk_abc123 on chain 84532"

This returns a webhook path (like a1b2c3d4) that you'll use to execute the service.

5. Execute

"Execute service at webhook path a1b2c3d4 with input {"city": "San Francisco"} using wallet wk_abc123"

The service runs your workflow and returns the result. The execution price (e.g., $0.01) is automatically deducted from your InUSD balance.

Note: execute-service doesn't need a chain ID — the webhook already knows its chain.

6. Check results

"Check execution result abc123-def456 on chain 84532"

7. Check settlement (optional)

Payments are settled on-chain in batches every 5 minutes. To verify a payment has settled:

"Check settlement for execution abc123-def456 on chain 84532"

Quick reference: full flow

purchase-service → get-activation-requirements → complete-credentials (if needed)  → activate-service → register-webhook → execute-service → check-execution

Publishing Services

If you're a builder, you can publish your own automation services:

When registering a service, you'll need to provide:

• A name and description
• Pricing: purchase price (e.g., $0.01 = 10000 microtokens), execution price, max execution price
• A workflow (the automation logic in JSON format)
• A category and tags

Budget Management

Services that run on the owner-pays model need a funded budget:

The amount is in microtokens: $10 = 10000000 microtokens.

Using Without a Wallet

If you're a developer building an x402-compatible AI agent, you can use indie.money's MCP server without a managed wallet. When you call a paid tool without providing a wallet key, the server returns standard x402 payment requirements. Your agent can then sign the payment with its own wallet and retry.

This follows the x402 payment protocol — an open standard for machine-to-machine payments.

Troubleshooting

"Wallet not found"Check that you're using the correct wallet key. Wallet keys start with wk_ and are case-sensitive.

"Missing X-Chain-ID"You forgot to specify the chain. Add "on chain 84532" (testnet) or "on chain 8453" (production) to your request.

"You do not own this service NFT"You need to purchase the service before you can activate or use it.

"Insufficient balance"Your wallet doesn't have enough InUSD. Get test tokens (testnet) and swap USDC to InUSD first.

"Purchase price below minimum"Service prices must be at least $0.01 (10,000 microtokens).

All Available Commands

Wallet (no chain ID needed)

• create-wallet — Create a new wallet, returns wallet key
• get-address — Get wallet address by key
• delete-wallet — Permanently delete a wallet

Discover (chain ID required)

• browse-marketplace — Browse featured and listed services
• get-service — Get full service details (pricing, nodes, creator)
• check-activation — Check if a service instance is activated
• check-execution — Check execution status and results
• list-executions — List your past executions with pagination
• get-balance — Check token balance (USDC or InUSD)
• get-activation-requirements — Check what credentials are needed
• get-credential-status — Check credential connection status
• get-swap-quote — Preview swap rates before swapping

Use Services (chain ID required, except execute)

• purchase-service — Buy a service NFT
• activate-service — Activate a purchased service
• register-webhook — Register a webhook for execution
• execute-service — Run a service workflow (no chain ID needed)
• check-settlement — Check on-chain settlement status
• update-service-metadata — Update service name, description, category, or tags

Publish Services (chain ID required)

• register-service — Publish a new service
• list-service — List on the marketplace
• delist-service — Remove from marketplace (reversible)
• boost-service — Feature service for N days (burns Boost Passes)

Billing (chain ID required)

• get-test-tokens — Get free testnet tokens (1000 USDC)
• fund-budget — Fund a service budget with InUSD
• withdraw-budget — Withdraw remaining budget
• swap-tokens — Swap between USDC and InUSD
• purchase-pass — Buy a Listing Pass ($2.99) or Boost Pass ($1.99)

Referral Program (chain ID required)

• register-referral — Create a referral code and optional vanity URL
• claim-referral — Claim someone's referral code for rewards
• get-referral-stats — Check referral stats for an address

Favorites (chain ID required)

• get-likes — Get your liked services list
• toggle-like — Add or remove a service from favorites

Data Tables (chain ID required)

• list-data-tables — List data tables for a service instance
• get-data-table-rows — Query rows from a data table

Credentials (chain ID varies)

• create-vault-session — Start a credential setup session (no chain ID)
• complete-credentials — Submit credentials (chain ID required)
• save-credential-connections — Map credentials to a service (chain ID required)

Advanced

• call-api — Call any API endpoint directly (chain ID optional)