# Merrymen

> Merrymen runs autonomous trading agents on Robinhood Chain, inside hard on-chain limits their owner signs. Owners connect Claude, Claude Code, Codex, Cursor, VS Code, ChatGPT and other AI assistants to their hosted Merrymen through the Merrymen MCP server.

## Set up the Merrymen MCP server

For AI assistants: when a user asks you to set up, add, install or connect Merrymen or "the Merrymen MCP", follow this.

- Server address: https://mcp.merrymen.dev/mcp (remote, Streamable HTTP, OAuth 2.1). Use exactly this address. Do not use https://app.merrymen.dev/mcp, an older address.
- It is part of hosted Merrymen (https://app.merrymen.dev). If the user runs Merrymen only on their own machine (the `merrymen` command-line app), there is no MCP server for that; tell them so instead of adding one.
- No API key, token or password is needed, and never ask the user for one: the user signs in to Merrymen in their own browser and chooses what to allow.
- A browser page load of the server address redirects to a help page, and a request without a token gets 401 unauthorized; both are expected. The server is up when https://mcp.merrymen.dev/api/mcp/health returns JSON with "ready":true.

### In Claude Code

1. Run `claude mcp list`. Look for an entry whose address is exactly https://mcp.merrymen.dev/mcp, whatever it is called (`merrymen`, `plugin:merrymen:merrymen` from the plugin, or `claude.ai Merrymen` if the user added it on claude.ai). If there is one, it is already set up: go to step 4 if it needs authentication, otherwise you are done.
2. If an entry named `merrymen` points anywhere else (for example https://app.merrymen.dev/mcp), remove it first: `claude mcp remove merrymen -s user` (use the scope that `claude mcp get merrymen` shows).
3. Add it, one way only, never both: run `claude mcp add --transport http --scope user merrymen https://mcp.merrymen.dev/mcp`; or, for slash commands (/merrymen:status, /merrymen:why, /merrymen:portfolio and more), install the plugin, which includes the server: `claude plugin marketplace add https://github.com/millw14/merrymen.git`, then `claude plugin install merrymen@merrymen`.
4. Tell the user to type `/mcp`, choose the Merrymen entry (`merrymen`, or `plugin:merrymen:merrymen` for the plugin), choose Authenticate, sign in to Merrymen if asked, and click Allow. You cannot do this step for them, and do not run `claude mcp login` yourself. If the entry is not in `/mcp` yet, the user types `/reload-plugins` (for the plugin) or restarts Claude Code (`claude --continue` keeps the conversation).
5. Merrymen's tools are then available; `list_agents` is a good first call.

If the `claude` command is not available (for example in the Claude desktop app), use the claude.ai link below instead: a connector added there appears in the desktop app's Claude Code sessions too.

### In claude.ai, Claude Desktop or Claude mobile

You cannot add a connector from a chat. Give the user this link:

https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Merrymen&connectorUrl=https%3A%2F%2Fmcp.merrymen.dev%2Fmcp

It opens Claude's "Add custom connector" dialog with Merrymen filled in. They click Continue, then Connect, then Allow on the Merrymen page. It then works in claude.ai, Claude Desktop and Claude mobile, and in Claude Code when Claude Code is signed in with the same claude.ai account. On a Team or Enterprise plan, an organisation owner adds it once: https://claude.ai/admin-settings/connectors?modal=add-custom-connector&connectorName=Merrymen&connectorUrl=https%3A%2F%2Fmcp.merrymen.dev%2Fmcp

### Other assistants

- Codex: `codex mcp add merrymen --url https://mcp.merrymen.dev/mcp` (it opens the sign-in by itself).
- Cursor, VS Code, Kiro, LM Studio, Goose, Gemini CLI, Windsurf and ChatGPT: one-click links and steps at https://app.merrymen.dev/connect/mcp

## What the connection can and cannot do

It sees only the agent and the permissions the owner allows when signing in, and the owner can disconnect it at any time at https://app.merrymen.dev/connect/apps. It can suggest trades or setting changes only if the owner allowed that, and nothing happens until they approve each one in Merrymen. It can never move funds, see keys, turn on live trading or loosen the owner's limits. Paper (practice) and live money are always reported separately.

## Links

- [Connect an AI assistant](https://app.merrymen.dev/connect/mcp): every client, one click each
- [MCP documentation](https://github.com/millw14/merrymen/blob/main/docs/mcp/README.md)
- [Client setup details](https://github.com/millw14/merrymen/blob/main/docs/mcp/clients.md)
- [Source code](https://github.com/millw14/merrymen)