# Langbot in Claude

> Install the Langbot plugin in Claude Code, and Claude finds a strategy, tests it on recorded markets with real fees, runs it on paper and, when you ask, on your own Kalshi account.

Source: https://langbot.ai/docs/claude-plugin

Drop Langbot into Claude Code and Claude runs your trading bots for you: it finds a strategy for
something you follow, tests it on recorded markets with Kalshi's fees and a realistic delay, tells
you plainly how it did, deploys it as a **preview** on paper against live markets, and, when you
ask, **promotes** it to live on your own Kalshi account with a budget you set. Every version can be
**rolled back**. You do not need to know anything about data streams or APIs.

The whole path in one sitting: [From Claude to a live bot in 10 minutes](https://langbot.ai/docs/claude-quickstart).

## Install

In Claude Code:

```
/plugin marketplace add langbot-ai/claude-plugins
/plugin install langbot@langbot
```

The plugin adds two things:

- **The Langbot MCP server** at `https://mcp.langbot.ai/mcp`. The first time Claude uses it, your
  browser opens to sign in to Langbot and approve Claude. There is no token to copy.
- **The `langbot` skill**, which teaches Claude how to use Langbot well: what to offer first, how to
  test an idea honestly, and the rules for real money below.

Other MCP clients can add the server directly:
`claude mcp add --transport http langbot https://mcp.langbot.ai/mcp` (see [MCP server](https://langbot.ai/docs/mcp)).

## What a session looks like

> **You:** What can I do with Langbot?
>
> **Claude:** I can test a trading idea on real past markets, with Kalshi's fees and a realistic
> delay, then run it for you on paper against live markets, and later on your own Kalshi account.
> Want me to look for a strategy on something you follow?
>
> **You:** Trump's speeches.
>
> **Claude:** I tested three built-in strategies on the last four recorded speeches (6 runs), with
> fees on and at two reaction times. I'll show you each one's trades, net after fees and worst
> speech, and what changed when the bot was slower. Four events is a small sample. Want to run the
> one you pick on paper on every Trump mention market next week, $20 per speech?

Claude then deploys a **preview** (paper trading on live data) and checks on it when you ask.

## What you can ask for

| Ask | What Claude does |
|---|---|
| "Run it on paper, $50" | deploys a preview (`deploy_bot`) |
| "Change the budget to $30" | a new preview version replaces the old one |
| "Only around scheduled speeches" | adds a schedule (`windows: "calendar"`) |
| "Every market in this series, including new ones" | a series selector that picks up new markets |
| "Take it live" | sends you the Connect Kalshi page, waits for setup, confirms, promotes (`promote_bot`) |
| "Roll back to v2" | runs v2's configuration again (`rollback_bot`) |
| "How are my bots doing?" | the fleet: what runs, P&L by bot, recent log lines |
| "Stop everything" | the kill switch on every bot (`stop_all_bots`) |
| "At most 2 live bots and $100 at risk" | fleet limits (`set_fleet_limits`) |

**Your own code (coming soon):** next, Claude can deploy your own repo or script, in any language,
against a Kalshi-compatible paper exchange, then promote it the same way. See
[Hosted bots](https://langbot.ai/docs/hosted-bots#bring-your-own-code-coming-soon).

## Testing honestly

The skill makes Claude:

- test on several recorded events, not one, with fees always on and at more than one reaction time;
- keep parameter sweeps small (each server simulator run counts against your monthly allowance: 20
  on Free, unlimited on Pro under fair use; fetching event data never counts) and say how many runs
  it used;
- report losses as plainly as gains, and say why an idea failed: fees on thin edges, slower than
  the market, too few trades, one lucky event;
- never promise or imply a profit. Results on recorded markets do not predict future ones.

## Real money: the rules Claude follows

- **Keys are never pasted into the chat.** Claude gives you one link to your bot's page on
  langbot.ai; you connect Kalshi there. If you paste a key into the chat anyway, Claude tells you to
  delete it in Kalshi.
- On that page Langbot creates a Kalshi sub-account, moves only your budget into it, and makes a key
  that can only trade there, so Kalshi itself caps the bot at the budget and Langbot can never move
  money. See [Hosted bots](https://langbot.ai/docs/hosted-bots) for every step.
- Claude waits for the page to finish (it can see the setup's progress), asks you to confirm, then
  promotes the bot to live.
- "Stop" always works, from Claude or the page.

Live hosted bots are for Kalshi accounts in the US. Langbot never holds your money or takes
deposits, and charges a flat monthly plan, never a fee per trade or a share of profits
([Pricing and limits](https://langbot.ai/docs/pricing)).