SnapTrade MCP Server
SnapTrade offers a hosted Model Context Protocol (MCP) server that lets AI assistants like Claude and ChatGPT securely read a user's connected brokerage data through natural-language prompts. Once a user adds SnapTrade as a connector, they can ask their assistant about their balances, positions, orders, and account activity in plain language, and, on the trading server, preview, place, and cancel orders.
SnapTrade hosts two MCP servers:
| Server | URL | Access |
|---|---|---|
| Portfolio | https://agent.snaptrade.com/mcp/portfolio | Read-only account data, plus a link to connect a new brokerage |
| Trading | https://agent.snaptrade.com/mcp/trading | The same account data, plus order preview, placement, and cancellation |
https://mcp.snaptrade.com/mcp remains available as an alias of the portfolio server for existing connectors.
Before you begin
The SnapTrade MCP server is for SnapTrade Personal users — individuals who connect and manage their own brokerage accounts with SnapTrade. It is not used with SnapTrade developer (partner) API keys.
To use the connector, you'll need a free SnapTrade Personal account. If you don't have one yet, sign up at the SnapTrade Dashboard and link at least one brokerage account before adding the connector to your AI assistant.
The trading server also requires trading access to be enabled for your SnapTrade account and a brokerage connection with trade access. Trading access is not yet available for every account; when it is not enabled, the consent screen grants read access only and the trading tools are not available.
For a broader comparison of Personal and Commercial customer experiences, see SnapTrade Personal vs Commercial.
What you can do with it
With the SnapTrade connector enabled, an AI assistant can:
- List the brokerages a user is connected to and the accounts under each connection
- Retrieve account details, balances, and buying power
- Retrieve positions and holdings across accounts
- Review orders, recent orders, and order details
- Review historical account activity such as deposits, dividends, and fees
- Summarize portfolio value, allocation, and unrealized gains and losses across accounts
- Summarize dividends, interest, fees, and contributions for a period
- Show the user's Wealth Rank, when a placement is available
- List apps and tools from the SnapTrade app directory that work with the user's accounts
- Look up reference data such as stock exchanges and the brokerages available to the user
- Generate a one-time link the user can open to connect a new brokerage
On the trading server, an AI assistant can also:
- Preview an order, with a cost estimate and warnings, before anything is placed
- Place an order the user has previewed and confirmed
- Check the status of placed orders and cancel open orders
How it works
The MCP server is a thin protocol adapter in front of the SnapTrade Partner API. AI assistants speak MCP; SnapTrade exposes a REST API. The MCP server translates between the two and forwards each request to the same endpoints SnapTrade partners already use.
AI assistant → SnapTrade MCP server → SnapTrade Partner API → User's brokerages
No new data surface is introduced — the connector exposes a curated subset of existing SnapTrade endpoints. The portfolio server is read-only; the trading server adds order preview, placement, and cancellation.
Authentication and security
The connector uses the OAuth 2.0 authorization code grant with PKCE. When a user adds the connector, their AI assistant registers itself automatically using Dynamic Client Registration (RFC 7591). The user is then redirected to SnapTrade to log in and approve access. Tokens issued to the assistant are scoped to read on the portfolio server, and to read and trade on the trading server when the user approves trading. The MCP server validates every request using token introspection (RFC 7662) against SnapTrade's authorization server.
Clients can discover the connector's OAuth configuration at these endpoints:
| Server | Protected resource metadata | Authorization server metadata |
|---|---|---|
| Portfolio | https://agent.snaptrade.com/.well-known/oauth-protected-resource/mcp/portfolio | https://api.snaptrade.com/.well-known/oauth-authorization-server/mcp/portfolio |
| Trading | https://agent.snaptrade.com/.well-known/oauth-protected-resource/mcp/trading | https://api.snaptrade.com/.well-known/oauth-authorization-server/mcp/trading |
For details on what data the connector accesses and how it is handled, see the SnapTrade Connector Privacy Notice. For SnapTrade's overall security posture, see snaptrade.com/security.
Set up the SnapTrade connector in Claude
- In Claude, go to Settings → Connectors.
- Click Add, then Add custom connector.
- Enter a name (for example,
SnapTrade) and the MCP server URL:https://agent.snaptrade.com/mcp/portfoliofor read-only access, orhttps://agent.snaptrade.com/mcp/tradingfor trading. - Click Add, then Connect.
- Complete the SnapTrade login flow if prompted and approve access: read for the portfolio server, or read and Place trades in your accounts for the trading server.
- After you approve, the SnapTrade tools become available in Claude.
Set up the SnapTrade app in ChatGPT
- Go to chatgpt.com/plugins, click +, then Add custom MCP server.
- Enter a name (for example,
SnapTrade), a short description, and the MCP server URL:https://agent.snaptrade.com/mcp/portfoliofor read-only access, orhttps://agent.snaptrade.com/mcp/tradingfor trading. - Set authentication to OAuth, review the warning and select I understand and want to continue.
- Select Create as a plugin, then sign in to SnapTrade and approve access when prompted: read for the portfolio server, or read and Place trades in your accounts for the trading server.
- In a new chat, type @ and pick SnapTrade to use your portfolio data.
Example prompts
Once the connector is enabled, a user can ask their assistant questions like:
- "What brokerages am I connected to through SnapTrade?"
- "Show me my current balances and positions across all my accounts."
- "What were my last 10 orders across all my accounts?"
- "I'd like to connect my Alpaca account." — the assistant calls
request_connection_linkand hands the user a one-time URL to open in their browser.
On the trading server:
- "Buy 5 shares of AAPL in my Alpaca account at market." — the assistant previews the order, shows the estimate and any warnings, and asks the user to confirm before placing it.
- "Cancel my open limit order for VTI."
Available tools
Portfolio server
The portfolio server is read-only and exposes 19 tools. All read data except request_connection_link, which generates a connection link for the user to open.
Connections
Connections_listBrokerageAuthorizations— list the user's brokerage connectionsConnections_listBrokerageAuthorizationAccounts— list the accounts under a connection
Account information
AccountInformation_listUserAccounts— list all of the user's accountsAccountInformation_getUserAccountDetails— account details, including institution name and total valueAccountInformation_getUserAccountBalance— cash balances and buying powerAccountInformation_getAllAccountPositions— positions and holdings for an accountAccountInformation_getAccountBalanceHistory— historical account balancesAccountInformation_getUserAccountOrdersV2— orders for an accountAccountInformation_getUserAccountRecentOrdersV2— recent orders for an accountAccountInformation_getUserAccountOrderDetailV2— details for a single orderAccountInformation_getAccountActivities— historical account activity such as deposits, dividends, and fees
Portfolio summaries
get_portfolio_summary— total value, asset-type and currency allocation, concentration, and unrealized gains and losses across all accounts, in one reporting currencyget_income_summary— dividends, interest, fees, and contributions across all accounts for a period, in one reporting currencyget_wealth_rank— where the user's total holdings place them among SnapTrade members, when a placement is available
Reference data
ReferenceData_getStockExchanges— supported stock exchangesReferenceData_getPartnerInfo— brokerages and data access available to the connector
Apps and connections
list_snaptrade_apps— apps and tools from the SnapTrade app directory that work with the user's accountslist_supported_brokerages— list the brokerages the user can connectrequest_connection_link— generate a one-time URL the user opens to connect a new brokerage. The link is single-use and expires after 5 minutes. The assistant cannot complete the connection itself; only the user's browser session can.
Trading server
The trading server exposes 21 tools: the same connection, account, reference-data, portfolio-summary, and app and connection tools, except that AccountInformation_getUserAccountOrdersV2 and AccountInformation_getUserAccountRecentOrdersV2 are replaced by AccountInformation_getAllAccountOrders. It adds:
AccountInformation_getAllAccountOrders— orders for an account, in the same format used to place ordersTrading_previewSimpleOrder— validate an order and estimate its cost against the account's quote and cash balance, without placing it. Returns apreview_tokenvalid for 5 minutes.Trading_placeSimpleOrder— submit an order. Requires thepreview_tokenfrom a preview of the same order, so an order cannot be placed without a matching preview. The token does not prove the user saw or confirmed the preview; the tool instructions tell the assistant to show it and wait for confirmation, and that depends on the client following them.Trading_cancelOrder— cancel an open order
Supported securities are stocks and ETFs (fractional shares at eligible brokerages), single-leg and multi-leg options, and futures and futures options on tastytrade, subject to what each brokerage and account allows. Crypto orders are not available. Previews estimate cost for single-equity orders only; other orders are previewed with a "no quote" warning. A placed order is submitted to the brokerage, not necessarily filled.
Every tool is annotated so AI clients and users can tell read operations from write operations. Read tools, including Trading_previewSimpleOrder, are marked readOnlyHint: true and destructiveHint: false. request_connection_link is marked readOnlyHint: false and destructiveHint: false: it creates a link but changes no existing data. Trading_placeSimpleOrder and Trading_cancelOrder are marked destructiveHint: true; of the two, only Trading_cancelOrder is marked idempotent. Tools that read the user's brokerage data are marked openWorldHint: true; reference data, the app directory, list_supported_brokerages, and get_wealth_rank are marked openWorldHint: false.
Manage and revoke access
A user can revoke a connector's access at any time from the SnapTrade dashboard under Settings → Connected apps. Revoking access immediately invalidates the assistant's token.
This is separate from disconnecting a brokerage — revoking connector access removes the AI assistant's access to SnapTrade, but leaves the user's brokerage connections intact.
Support
- General support:
support@snaptrade.com - Security vulnerability reports:
security@snaptrade.com