Content
<div class="title-block" style="text-align: center;" align="center">
[](https://x.com/composertrade)
[](https://pypi.org/project/composer-trade-mcp)
[](https://www.reddit.com/r/ComposerTrade)
</div>
<p align="center">
<strong>Vibe Trading is here!</strong>
</p>
<p align="center">
Official <a href="https://www.composer.trade">Composer</a> Model Context Protocol (MCP) server that allows MCP-enabled LLMs like Cursor and Claude to validate investment ideas via backtests and even trade multiple strategies (called "symphonies") in parallel to compare their live performance.
</p>
## Features
- **Create automated investing strategies**
- Use indicators like Relative Strength Index (RSI), Moving Average (MA), and Exponential Moving Average (EMA) with a diverse range of equity and crypto offerings to build your ideal portfolio.
- Don't just make one-off trades. Composer symphonies constantly monitor the market and rebalance accordingly.
- Try asking: "_Build me a crypto strategy with a maximum drawdown of 30% or less._"
- **Backtest your ideas**
- Our Backtesting API provides a fast feedback loop for AI to iterate and validate its hypotheses.
- Try asking: "_Compare the strategy's performance against the S&P 500. Plot the results._"
- **Find a strategy tailored for you**
- Provide your criteria to the AI and it will search through our [database](https://www.composer.trade/symphony) of 1000+ strategies to find one that suits your needs.
- Try asking: "_Find me a strategy with better risk-reward characteristics than Bitcoin._"
- **Monitor performance**
- View performance statistics for your overall account as well as for individual symphonies.
- Try asking: "_Identify my best-performing symphonies. Analyze why they are working._"
- **Control your investments** (requires [Composer subscription](https://www.composer.trade/pricing))
- Ask AI to analyze your investments and adjust your exposure accordingly!
- Try asking: "_Research the latest trends and news. Analyze my symphonies and determine whether I should increase / decrease my investments._"
For more ideas, check out our collection of [Awesome Prompts](https://github.com/invest-composer/composer-trade-mcp/blob/main/AWESOME_PROMPTS.md)!
# Installation
This section will get you started with creating symphonies and backtesting them. Use the links below to jump to the instructions for your preferred LLM client:
- [Claude Desktop + iOS](https://github.com/invest-composer/composer-trade-mcp?tab=readme-ov-file#quickstart-with-claude-desktop-and-claude-ios)
- [Claude Code](https://github.com/invest-composer/composer-trade-mcp?tab=readme-ov-file#quickstart-with-claude-code)
- [Cursor](https://github.com/invest-composer/composer-trade-mcp#quickstart-with-cursor)
- [n8n](https://github.com/invest-composer/composer-trade-mcp#quickstart-with-n8n)
- [Other LLMs](https://github.com/invest-composer/composer-trade-mcp#manual-install-for-other-llm-clients)
## Quickstart with Claude Desktop and Claude iOS
**To use the Composer MCP, you’ll need the Claude Pro or Max [plan](https://www.anthropic.com/pricing).**
https://github.com/user-attachments/assets/f560c127-4c87-4932-b515-6cad962c8ddc
1. Make sure you have [Claude Desktop](https://claude.ai/download) installed.
2. From Claude Desktop, navigate to **Settings → Connectors** then click **Add custom connector**
3. Enter "Composer" in the Name field and `https://ai.composer.trade/mcp` in the Remote MCP server URL field.
4. Enter your Composer email and password in the login screen that opens.
1. That's it. Your MCP client can now interact with Composer! Try asking Claude something like, "_Find the Composer strategies with the highest alpha._"
Once you've followed the above steps, the Composer MCP server will automatically be accessible in the Claude iOS app.
## Quickstart with Claude Code
Run the following command from your terminal:
```
claude mcp add --transport http composer https://ai.composer.trade/mcp
```
## Quickstart with Cursor
Copy-paste the following into your browser:
```
cursor://anysphere.cursor-deeplink/mcp/install?name=Composer&config=eyJ1cmwiOiJodHRwczovL2FpLmNvbXBvc2VyLnRyYWRlL21jcCJ9
```
Try asking Cursor something like, "_Find the Composer strategies with the highest alpha._"
## Quickstart with n8n
1. Get your [API Key](https://github.com/invest-composer/composer-trade-mcp?tab=readme-ov-file#getting-your-api-key)
1. Base64 Encode your key and secret separated with `:`
- Example: `MY_KEY:MY_SECRET` becomes `TVlfS0VZOk1ZX1NFQ1JFVA==` after Base64 encoding
1. Make sure your n8n version is at least `1.104.0`
- Learn how to check and update your n8n version [here](https://docs.n8n.io/manage-cloud/update-cloud-version/).
1. Add "MCP Client Tool" as a tool for your agent
1. Input the following fields:
- Endpoint: `https://mcp.composer.trade/mcp/`
- Server Transport: `HTTP Streamable`
- Authentication: `Header Auth`
- Create a new credential and enter the following in the Connection tab:
- Name: `Authorization`
- Value: `Basic REPLACE_WITH_BASE64_ENCODED_KEY_AND_SECRET` (Use your Base64 encoded key and secret here)
1. Select which tools you want to allow your agent to use.
- We recommend **excluding** the following tools that can modify your account:
- `save_symphony` - Save a symphony to the user's account
- `copy_symphony` - Copy an existing symphony to the user's account
- `update_saved_symphony` - Update a saved symphony
- `invest_in_symphony` - Invest in a symphony for a specific account
- `withdraw_from_symphony` - Withdraw money from a symphony for a specific account
- `cancel_invest_or_withdraw` - Cancel an invest or withdraw request that has not been processed yet
- `skip_automated_rebalance_for_symphony` - Skip automated rebalance for a symphony in a specific account
- `go_to_cash_for_symphony` - Immediately sell all assets in a symphony
- `liquidate_symphony` - Immediately sell all assets in a symphony (or queue for market open if outside of market hours)
- `rebalance_symphony_now` - Rebalance a symphony NOW instead of waiting for the next automated rebalance
- `execute_single_trade` - Execute a single order for a specific symbol like you would in a traditional brokerage account
- `cancel_single_trade` - Cancel a request for a single trade that has not executed yet
## Manual install for other LLM clients
To install for any other MCP-enabled LLM, you can add the following to your MCP configuration JSON:
```
{
"mcpServers": {
"composer": {
"url": "https://ai.composer.trade/mcp"
}
}
}
```
‼️ **NOTE: ChatGPT does not support custom MCP servers unless you have the Pro Plan ($200/mo). They also do not support MCP servers with more than two tools.** ‼️
## Getting your API Key
An API key will be necessary to interact with your Composer account. For example, saving a Composer Symphony for later or viewing statistics about your portfolio.
Trading a symphony will require a paid subscription, although you can always liquidate a position regardless of your subscription status. Composer also includes a 14-day free trial so you can try without any commitment.
Get your API key from [Composer](https://app.composer.trade) by following these steps:
1. If you haven't already done so, [create an account](https://app.composer.trade/register).
1. Open your "Accounts & Funding" page
1. Request an API key
<div align="center">
<img src="https://github.com/user-attachments/assets/df6d8f23-de5a-44fb-a1c7-0bffa7e3173f" alt="CleanShot 2025-06-25 at 14 35 15@2x" width="500">
</div>
1. Save your API key and secret
<div align="center">
<img src="https://github.com/user-attachments/assets/dd4d2828-6bfd-4db5-9fe0-6a78694f87c6" alt="CleanShot 2025-06-25 at 14 35 15@2x" width="500">
</div>
## Available tools
Once your LLM is connected to the Composer MCP Server, it will have access to the following tools:
- `create_symphony` - Define an automated strategy using Composer's system.
- `backtest_symphony` - Backtest a symphony that was created with `create_symphony`
- `search_symphonies` - Search through a database of existing Composer symphonies.
- `backtest_symphony_by_id` - Backtest an existing symphony given its ID
- `save_symphony` - Save a symphony to the user's account
- `copy_symphony` - Copy an existing symphony to the user's account
- `update_saved_symphony` - Update a saved symphony
- `list_accounts` - List all brokerage accounts available to the Composer user
- `get_account_holdings` - Get the holdings of a brokerage account
- `get_aggregate_portfolio_stats` - Get the aggregate portfolio statistics of a brokerage account
- `get_aggregate_symphony_stats` - Get stats for every symphony in a brokerage account
- `get_symphony_daily_performance` - Get daily performance for a specific symphony in a brokerage account
- `get_portfolio_daily_performance` - Get the daily performance for a brokerage account
- `get_saved_symphony` - Get the definition about an existing symphony given its ID.
- `get_market_hours` - Get market hours for the next week
- `get_options_chain` - Get options chain data for a specific underlying asset symbol with filtering and pagination
- `get_options_contract` - Get detailed information about a specific options contract including greeks, volume, and pricing
- `get_options_calendar` - Get the list of distinct contract expiration dates available for a symbol
- `invest_in_symphony` - Invest in a symphony for a specific account
- `withdraw_from_symphony` - Withdraw money from a symphony for a specific account
- `cancel_invest_or_withdraw` - Cancel an invest or withdraw request that has not been processed yet
- `skip_automated_rebalance_for_symphony` - Skip automated rebalance for a symphony in a specific account
- `go_to_cash_for_symphony` - Immediately sell all assets in a symphony
- `liquidate_symphony` - Immediately sell all assets in a symphony (or queue for market open if outside of market hours)
- `preview_rebalance_for_user` - Perform a dry run of rebalancing across all accounts to see what trades would be recommended
- `preview_rebalance_for_symphony` - Perform a dry run of rebalancing for a specific symphony to see what trades would be recommended
- `rebalance_symphony_now` - Rebalance a symphony NOW instead of waiting for the next automated rebalance
- `execute_single_trade` - Execute a single order for a specific symbol like you would in a traditional brokerage account
- `cancel_single_trade` - Cancel a request for a single trade that has not executed yet
## Recommendations
We recommend the following for the best experience with Composer:
- Use Claude Opus 4 instead of Sonnet. Opus is much better at tool use.
- Turn on Claude's Research mode if you need the latest financial data and news.
- Tools that execute trades or affect your funds should only be allowed once. Do not set them to "Always Allow".
- The following tools should be handled with care: `invest_in_symphony`, `withdraw_from_symphony`, `skip_automated_rebalance_for_symphony`, `go_to_cash_for_symphony`, `liquidate_symphony`, `rebalance_symphony_now`, `execute_single_trade`
## Troubleshooting
Logs when running with Claude Desktop can be found at:
- **Windows**: `%APPDATA%\Claude\logs\mcp-server-composer.log`
- **macOS**: `~/Library/Logs/Claude/mcp-server-composer.log`
---
_Please review the [API & MCP Server Disclosure](https://storage.googleapis.com/www.investcomposer.com/docs/COM%20sh%20-%20API%20%26%20MCP%20Server%20Disclosure.pdf) before using the API_
