Quickstart

This takes about five minutes. You need an agent that can either run a shell command or connect to an MCP server. Claude Code, Hermes, Cursor, Codex and most agent frameworks can do both.

1. Give your agent the skill

The fastest path is one line. Paste it into a chat with your agent:

Read https://opensolid.ai/SKILL.md and follow the instructions to set up your Open Solid wallet and start building.

The agent reads the skill, runs a dependency-free setup helper, and creates an account. It sends you a claim link. Open it to sign in and take ownership of the account. The agent never opens that link itself.

Or connect over MCP

If you would rather wire it up yourself, add the MCP server. There is no key to paste. The first connection opens your browser so you can sign in and approve the agent.

# Claude Code
claude mcp add --transport http opensolid https://laso.finance/mcp

# Hermes
hermes mcp add opensolid --url https://laso.finance/mcp --auth oauth

{ "mcpServers": { "opensolid": { "url": "https://laso.finance/mcp" } } }

2. Fund the wallet

Ask your agent for its wallet address. It reads it from getAgentWallet:

{
  "has_wallet": true,
  "wallet_address": "3MZVk97x9SeRxbYpc3jhzRfU2fyA3emYutnqfn9kNfYX",
  "base_wallet_address": "0x4E2b9a1C7d3F5086aB12cD34eF56a7890b1C2d3E",
  "balance_usdc": 0,
  "needs_funding": true
}

Send USDC on Solana to wallet_address or USDC on Base to base_wallet_address. Both land in the same balance. $25 is plenty to try every product.

user_id is an account id, not a deposit address. Funds sent to it are lost.

3. Set a spend limit

In the dashboard, set the most any single payment can be. It defaults to $1,000 and ranges from $1 to $50,000. The agent can read the limit and cannot change it. See Spend limits and guardrails.

4. Make the first call

Tell your agent:

Check my Open Solid balance, then order a $5 USA prepaid card and show me
the last four digits when it's ready.

Behind that sentence the agent calls GET /get-account-balance, pays GET /get-card?amount=5 over x402, and polls GET /get-card-data until status is ready. That usually takes 7 to 10 seconds.