composer-trade-mcp

invest-composer/composer-trade-mcp

3.6

If you are the rightful owner of composer-trade-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Composer MCP Server is a platform that enables MCP-enabled LLMs to validate investment ideas through backtesting and manage multiple trading strategies.

Tools
5
Resources
0
Prompts
0

composermcpheader

Twitter PyPI Reddit Community

Vibe Trading is here!

Official Composer 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.

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 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)
    • 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!

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:

Quickstart with Claude Desktop and Claude iOS

To use the Composer MCP, you’ll need the Claude Pro or Max plan.

https://github.com/user-attachments/assets/f560c127-4c87-4932-b515-6cad962c8ddc

  1. Make sure you have Claude Desktop 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.
  5. 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
  2. Base64 Encode your key and secret separated with :
    • Example: MY_KEY:MY_SECRET becomes TVlfS0VZOk1ZX1NFQ1JFVA== after Base64 encoding
  3. Make sure your n8n version is at least 1.104.0
    • Learn how to check and update your n8n version here.
  4. Add "MCP Client Tool" as a tool for your agent
  5. 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)
  6. 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 by following these steps:

  1. If you haven't already done so, create an account.
  2. Open your "Accounts & Funding" page CleanShot 2025-06-25 at 14 28 12@2x
  3. Request an API key
  4. Save your API key and secret

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 before using the API