
# 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:

```text
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.

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

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

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

## 2. Fund the wallet

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

```json
{
  "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](/docs/guardrails).

## 4. Make the first call

Tell your agent:

```text
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.

## Next

- [The founder loop](/docs/founder-loop): give the agent a business to run.
- [Core concepts](/docs/concepts): wallets, balances, pay-per-call and credentials.
