# Coding with agents

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

Set up an AI coding agent to build BSV blockchain apps the way these docs describe, with the BSV blockchain docs server, the bsv-dev skill and @bsv/mcp, on testnet.

import AgentToolkit from '/snippets/AgentToolkit.jsx';

Set up an AI coding agent, such as [Claude Code](https://code.claude.com/docs/en/overview), Cursor, Windsurf or VS Code, so it builds BSV blockchain apps the way these docs describe. It takes three pieces: the BSV blockchain docs server gives the agent these pages, the `bsv-dev` skill gives it the decisions, and `@bsv/mcp` gives it tools. In Claude Code, one plugin installs all three. Use it when an agent writes your code for the BSV blockchain. At the end, the agent reads the docs, builds on testnet, keeps keys out of the code and checks its work against the BSV blockchain guardrails.

## How it works

Each piece gives the agent something different:

<AgentToolkit />

- BSV blockchain docs server, `bsv-docs`: gives search and full pages of these docs, as Markdown. Use it for answers and code that follow these guides.
- `bsv-dev` skill: gives the decisions, as a playbook the agent loads for BSV blockchain work: who holds the keys, wallet login on a computer or a phone, payments and payment channels, BSV Broadcaster (formerly Arcade) and when a payment is final, testnet to Mainnet, the guardrail review. Use it for building the way these docs do.
- `@bsv/mcp`, `bsv-mcp`: gives tools that act and read live data: broadcast and status on BSV Broadcaster, a guardrail check of a project, BRCs and versions, plus dated facts. Use it for actions and live values, on testnet unless you configure Mainnet.

Everything starts on testnet, where the coins have no value and come free from the faucet. Where the wallet lives is the app's choice, and the skill makes it per money path. In shape A, the app asks the user's BRC-100 (The standard interface between an app and a wallet) wallet to sign. The skill gives every new app a login with two paths: [BSV Desktop](https://desktop.bsvb.tech/) on the same computer, and a phone wallet such as [BSV Browser](https://bsvblockchain.com/docs/wallets/bsv-browser/), paired by QR code. BSV Desktop signs within the small monthly allowance the user granted to the app, and prompts for anything above it. In shape B, the app runs its own server wallet, which pays with no user present. No tool takes a private key, and the skill never asks for one.

## What you can ask

With the pieces set up, try requests like these:

- `Add tipping to my React app on BSV. Use BSV Desktop on testnet.`
- `Check the status of transaction TXID on BSV Broadcaster and tell me whether it is final.` Replace `TXID` with the transaction ID.
- `Review this project against the BSV guardrails and fix every error.`
- `Which wallet shape fits an app that pays creators automatically every night?`
- `Should my game use a payment channel or one payment per move?`
- `Send my first BSV payment from a small Node.js script. Build it and run it.` [Send a payment with an AI agent](https://bsvblockchain.com/docs/build-with-ai/prompts/) walks through this one.

## Set up your agent

In Claude Code, install the plugin. Without it, add each piece on its own. The next two pages show each command with its output.

### Install the plugin in Claude Code

The `bsv-dev` plugin holds the skill and both MCP servers, `bsv-docs` and `bsv-mcp`. It starts `@bsv/mcp` on your machine through `npx`, which needs Node.js 22 or newer:

```bash
claude plugin marketplace add bsv-blockchain/bsv-ai-toolkit && claude plugin install bsv-dev@bsv
```

With the plugin, do not also add the servers with `claude mcp add`, or Claude Code starts a second copy of `bsv-mcp`. If you added them before, remove them first, as [Install the BSV blockchain agent skill](https://bsvblockchain.com/docs/build-with-ai/skill/) shows.

### Set up without the plugin

To connect only the two servers in Claude Code, without the skill, run these commands in your project folder instead of installing the plugin. The docs server runs on this site and needs no login, and `@bsv/mcp` runs through `npx` and needs Node.js 22 or newer:

```bash
claude mcp add --transport http bsv-docs https://bsvblockchain.com/docs/mcp
claude mcp add bsv-mcp -e BSV_NETWORK=testnet -- npx -y @bsv/mcp
```

In any other agent that reads Agent Skills, install the skill on its own, then add the two servers as JSON, as in [Use another AI tool](https://bsvblockchain.com/docs/build-with-ai/mcp/#use-another-ai-tool):

```bash
npx skills add bsv-blockchain/bsv-ai-toolkit
```

**[Install the BSV blockchain agent skill](https://bsvblockchain.com/docs/build-with-ai/skill/)**

Install the skill or the Claude Code plugin, and see what the skill decides and what stays yours.

**[Connect your AI tool with MCP](https://bsvblockchain.com/docs/build-with-ai/mcp/)**

See the tools of the docs server and `@bsv/mcp`, add them without the plugin and check a project against the guardrails.

## Skills library

The official skill is `bsv-dev`, maintained by BSV Association in [bsv-blockchain/bsv-ai-toolkit](https://github.com/bsv-blockchain/bsv-ai-toolkit).

Skills from other authors are listed in [`community-skills.yaml`](https://github.com/bsv-blockchain/bsv-ai-toolkit/blob/main/community-skills.yaml) in the same repository. Each one is added by pull request, with every link pinned to the commit that was reviewed. The list is empty today.

## Next steps

With the agent set up, start from a working app, let the agent send a first testnet payment, or read the docs the way it does:

- [Start from the tipping sample](https://bsvblockchain.com/docs/build-with-ai/tipping-sample/)
- [Send a payment with an AI agent](https://bsvblockchain.com/docs/build-with-ai/prompts/)
- [Give agents the docs in Markdown](https://bsvblockchain.com/docs/build-with-ai/llm-resources/)