moomoo MCP and moomoo AI Trading: set up your AI agent with Claude and Coil
moomoo gives your agent hands. Coil gives it judgment. What moomoo’s MCP server does, which OAuth scopes you choose, and how to run both servers in one client.
The one-sentence map: moomoo provides the account and the order access. Your AI client provides the agent. Coil provides the read that decides whether, when and what to trade — served to your agent over MCP and never connected to your brokerage account.
Coil is not affiliated with moomoo. Coil is also independent of Anthropic, OpenAI and the other AI providers named here. Everything below about moomoo comes from moomoo’s own MCP documentation: its overview, Quick Start, authentication, available tools and Q&A pages, as read on November 15, 2026. moomoo updates these pages, so check them for the current version. Nothing here is investment advice.
If you came for the connection, it is five steps below: connect moomoo’s MCP, then add Coil’s in the same client, which is free and needs no key. If you came to decide whether an agent that can place orders is enough on its own, start with why an agent with hands still needs judgment.
What moomoo shipped
moomoo’s documentation describes its MCP server as a way to “connect AI assistants to moomoo OpenAPI through the standardized MCP protocol”, so that you can query quotes, manage portfolios and “execute trades via natural language.” It is an endpoint at https://mcp.moomoo.com/mcp, and moomoo lists Claude Desktop, Claude Code and Cursor as supported clients, plus other MCP-compatible tools. moomoo’s FAQ counts the setup as two steps: configure your client with the endpoint, then authorize through the OAuth flow when prompted.
Four scopes, granted separately
moomoo’s authentication page says the server uses OAuth 2.1, and that your client takes you to a moomoo consent page where you log in and “choose which scopes to authorize.” There are four, and the FAQ says you can grant them independently:
- quote:read — quotes, historical candlesticks and market data.
- quote:write — manage watchlist symbols.
- trade:read — account balance, positions and historical orders.
- trade:write — submit and cancel orders.
That split is the useful control here: an agent given the two read scopes can look at your account and the market and cannot place an order. moomoo says access tokens are short-lived, typically 2 hours, and refresh transparently, but that tokens expire after 14 days of inactivity by default, after which the client asks you to authorize again. You can revoke a token manually from the console. Its FAQ says no credentials are stored on the MCP server; the tokens are saved locally by the AI client, so keep them private.
moomoo’s own getting-started path
moomoo recommends a step-by-step approach, and it is a good one to follow. Step 1 is read-only queries, which need only the quote read and trade read scopes and, in moomoo’s words, “won’t affect your account in any way.” Step 2 is watchlist management. Step 3 is trading, which “requires trade:write scope and trade password.” For orders its page says: “Always confirm the symbol and quantity before executing.” It adds a warning that trading operations involve real funds and recommends testing with small amounts first. The page does not describe a separate confirmation screen for each order, so decide for yourself what your agent must show you first. At the time it was read, the page’s tool list was still loading, so this guide names no individual tools.
moomoo’s FAQ also notes that connected tools can be unavailable because of account or regional restrictions, since certain markets or features may be limited by account tier or region, and that a trade failure can mean your account’s trading permissions and market eligibility need checking.
Why an agent with hands still needs judgment
moomoo’s MCP answers one question well: can my agent act on my account, inside scopes I set? It does not try to answer the other one: should it act now, on this name, at this price? That is a market question, and a scope you grant once does not answer it every morning.
Quotes are not a view
The quote scope gives an agent live prices and candlesticks, and moomoo’s own example prompts include a daily chart for the past month. A price and a chart tell the agent what happened. They do not say whether the move is an entry, a chase or the last leg of something already over. Coil scores every name on whether the price is inside its entry window or already extended. A name far above its entry is a chase, and the rules refuse to chase. A name that is falling is not bought at all.
Positions need a trend check
Once an agent can read your positions, the question changes. A position that is down is not necessarily one to sell, and one that is up is not necessarily one to keep. The question that matters is whether the trend behind the holding is still intact. When it is broken, the reason for owning the name is gone whatever the P&L reads, and exits come before entries. Coil’s hold read answers that question for each name.
Holding cash
An agent that can always submit an order has no way to say “do nothing today”. Coil’s market read does: it tells the agent whether the day is worth trading, and on a cash reading nothing new opens. Cash is a position, and an empty list on a given day is the discipline working.
None of this makes an order less your responsibility. A read can make an agent’s choices more consistent from one session to the next. It cannot see an order after it is placed and it cannot cap a loss. The scopes you grant at moomoo, and the amount you fund, do that. Use both.
Step by step: moomoo’s MCP and Coil’s MCP in the same client
Step 1 — Check your account and the scopes you want
You need a moomoo account and the ability to complete moomoo’s OAuth login. moomoo says certain markets or features may be limited by account tier or region, so check your account’s trading permissions and market eligibility before you plan anything around it. Decide now that the first sessions use the read scopes only.
Step 2 — Connect moomoo’s MCP, with the read scopes first
moomoo’s Quick Start gives the endpoint and a command for Claude Code:
claude mcp add moomoo-mcp --transport http https://mcp.moomoo.com/mcp
For Claude Desktop and Cursor it gives a configuration entry pointing at the same URL; use moomoo’s own page for those, because moomoo keeps it current. On your first moomoo query, your client opens moomoo’s consent page. Authorize through that page directly; never paste your moomoo password into the agent or into a third-party site. On the consent page, grant quote:read and trade:read and leave the write scopes off. Then verify with a read, as moomoo suggests: “What is the current price of Tencent?” or “What stocks do I currently hold?”
Step 3 — Add Coil’s MCP in the same client
Coil’s server is a second MCP connection, free, with no key, wallet or account. The address is:
https://mcp.coil.trade/mcp
In Claude Code, one command adds it:
claude mcp add --transport http coil https://mcp.coil.trade/mcp
In a desktop or web client, add it as a remote MCP server by URL in the connector or settings screen; the connect page has the one-click installs and a panel for each client. Then ask the agent: “What is the stock market doing, and is it worth trading?” A clean answer from Coil’s server confirms the connection. Coil’s server has no brokerage tools, so nothing on it can reach your brokerage account.
Step 4 — Give the agent a read order
Both servers are now in one client, and the agent will use whichever it is pointed at. Point it. The prompts in the next section fix the order: Coil’s read first, moomoo’s tools second. Run it on the read scopes for a few weeks of sessions, asking the agent what it would have done and why, before you widen anything. moomoo’s watchlist step is a gentle second stage, if you want the agent to keep a list of what Coil called an entry.
Step 5 — Add the trade write scope, in small amounts
When the behavior is boring, re-authorize with trade:write, which moomoo says needs your trade password. Follow moomoo’s advice: confirm the symbol and quantity every time, and start with small amounts. Write the pause into your instructions (“show me the symbol and quantity and wait for my reply”); that is an instruction to the agent, not a lock, so the scopes and the amount you fund do the real limiting. Fund the account only with cash you could lose, and know where the console’s revoke is before you need it.
Example prompts for an agent using Coil’s reads
Start with prompts you run yourself, with every order waiting on you. Each fixes the order of the reads, so the agent behaves the same way every session.
Before any trade idea: “Ask Coil whether the market is worth trading today. If Coil reads cash, propose nothing new and tell me why.”
Looking for entries: “Ask Coil which stocks are at an entry. Compare them with my moomoo watchlist. Skip any name Coil calls extended or falling, and tell me why for each one you skip.”
Checking what I hold: “For each position I hold at moomoo, ask Coil whether the trend is still intact. Tell me which broken trends you would sell, and wait for my reply. Exits come before entries.”
Before buying one name: “Ask Coil for a read on this ticker. If its price is above its entry window, tell me it is a chase and do not submit the order.”
When you are ready to write standing instructions for the agent, write them as rules it can check one by one, in this order:
- Read Coil’s market read first. If it says cash, make no new orders.
- Buy only a name Coil places inside its entry window. Never buy a name Coil calls extended or falling.
- Before every hold, ask Coil whether the trend behind the position is intact. A broken trend means sell it.
- Show me the symbol and quantity and wait for my reply before you submit anything.
- If Coil’s server does not answer, make no new orders.
Two things stay in your half of the instructions. Position size and the most you will allow on one order are yours to write, because Coil’s free reads publish scores and states, never position sizes. The Coil Live feed adds each name’s structural stop and target and the rulebook that sizes a position on that stop, refreshed about every 5 minutes during market hours; on Live, the agent’s opening prompt shrinks to one line, “call get_live_setup and follow it.”
FAQ
What is the moomoo MCP server?
moomoo describes it as a way to connect AI assistants to moomoo OpenAPI through the Model Context Protocol, to query quotes, manage portfolios and execute trades in natural language. It is an endpoint at https://mcp.moomoo.com/mcp, and moomoo says your client guides you through an OAuth flow.
Can Claude trade my moomoo account?
moomoo names Claude Desktop, Claude Code and Cursor as supported clients, plus other MCP-compatible tools. With the trade write scope granted and your trade password, the agent can submit and cancel orders. moomoo’s getting-started page says to always confirm the symbol and quantity before executing, and describes no separate confirmation screen. The agent has the access and no view of its own on whether a trade is worth making. That view is the part Coil supplies.
What are the four moomoo OAuth scopes?
On moomoo’s authentication page: quote read covers quotes, historical candlesticks and market data; quote write manages watchlist symbols; trade read covers account balance, positions and historical orders; trade write covers submitting and cancelling orders. You choose which scopes to grant on the consent page, and you can grant them independently.
How do I stop the connection?
moomoo says access tokens can be revoked manually from the console, and that you can invalidate tokens at any time from the Dashboard. If you suspect your credentials are compromised, it says to disable the affected token in the console immediately. Tokens also expire after 14 days of inactivity by default, and the client then asks you to authorize again.
Does Coil connect to my moomoo account?
No. Coil’s MCP server has no brokerage tools and never sees your account. Your agent reads Coil for the market read and places any order through moomoo’s own connection. Coil never holds accounts or keys.
What does it cost to add Coil?
Coil’s free MCP server needs no key, wallet or account: a delayed sample of the board’s morning read. Coil Live, the full read your agent calls over the same kind of MCP connection, is $49/mo or $419/yr, with a 7-day free trial. Nothing is installed. moomoo’s own terms, fees and market data are on moomoo’s site.
Is letting an AI agent trade my moomoo account risky?
moomoo’s own page warns that trading operations involve real funds, to proceed with caution and to test with small amounts first. Coil does not remove that risk and cannot see or stop an order. A read can make an agent’s decisions more consistent; the scopes you grant and the amount you fund are what cap the damage. You can lose money, so fund the account only with cash you could lose.
Does it work with clients other than Claude?
moomoo names Claude Desktop, Claude Code and Cursor, and says any MCP client that supports the http transport can connect. Coil’s MCP server is one URL that any client taking a remote MCP server can add, so the same two-server setup applies. The steps differ by client; each client’s own documentation covers its own version.
Your agent has hands. Give it a read.
Add Coil’s MCP server to the client that already talks to moomoo. It is free, with no key or account: https://mcp.coil.trade/mcp. Coil Live adds the full board, each name’s structural stop and target and the served rulebook, refreshed about every 5 minutes during market hours ($49/mo or $419/yr, nothing installed). Coil is not affiliated with moomoo.
Coil is software and impersonal research, not investment advice. It never sells a stock short. On down days it may buy an inverse ETF, as a hedge or as a same-day trade. It is not a managed account and not a signal service. Leveraged ETFs, where the engine uses them, can lose value rapidly, including total loss. Backtests are research, not returns; the live record is Coil's engine trading one real brokerage account, published win or lose, not a projection of yours. Past performance does not predict future results.