Skip to content

Composer's MCP server lets MCP-enabled LLMs like Claude backtest trading ideas and automatically invest in them for you

License

Notifications You must be signed in to change notification settings

Str1k3-68/composer-trade-mcp

 
 

Repository files navigation

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 (requires API Key)
    • 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 API Key + 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. You don't even need a Composer account to use these features! Note that more advanced features will require an API Key.

Use the links below to jump to the instructions for your preferred LLM client:

Quickstart with Claude Desktop

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

  1. Make sure you have Claude Desktop installed.
  2. Download composer-trade-mcp.dxt
  3. Go to Claude > Settings > Extensions then click "Install Extension" and select composer-trade-mcp.dxt.
  4. Click "Install"
    • You can choose to add your API Key here for more advanced features but it's not necessary for backtesting.
  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."

Quickstart with Cursor

Use one of the following links depending on whether you want to use the MCP server with or without an API Key.

  • Without an API Key
    • Copy-paste the following into your browser:
      cursor://anysphere.cursor-deeplink/mcp/install?name=composer&config=eyJjb21tYW5kIjoibnB4IC15IG1jcC1yZW1vdGUgaHR0cHM6Ly9tY3AuY29tcG9zZXIudHJhZGUvbWNwLyJ9
      
  • With an API Key (recommended)
    • Copy-paste the following into your browser:
      cursor://anysphere.cursor-deeplink/mcp/install?name=composer&config=eyJjb21tYW5kIjoibnB4IC15IG1jcC1yZW1vdGUgaHR0cHM6Ly9tY3AuY29tcG9zZXIudHJhZGUvbWNwLyAtLWhlYWRlciB4LWFwaS1rZXktaWQ6JHtDT01QT1NFUl9BUElfS0VZfSAtLWhlYWRlciBBdXRob3JpemF0aW9uOiR7Q09NUE9TRVJfU0VDUkVUX0tFWX0iLCJlbnYiOnsiQ09NUE9TRVJfQVBJX0tFWSI6IlJFUExBQ0VfV0lUSF9ZT1VSX0FQSV9LRVkiLCJDT01QT1NFUl9TRUNSRVRfS0VZIjoiQmVhcmVyIFJFUExBQ0VfRlJPTV9IRVJFX1dJVEhfWU9VUl9TRUNSRVRfS0VZIn19
      

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": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.composer.trade/mcp/",
        "--header",
        "x-api-key-id:${COMPOSER_API_KEY}",
        "--header",
        "Authorization:${COMPOSER_SECRET_KEY}"
      ],
      "env": {
        "COMPOSER_API_KEY": "REPLACE_WITH_YOUR_API_KEY",
        "COMPOSER_SECRET_KEY": "Bearer REPLACE_FROM_HERE_WITH_YOUR_SECRET_KEY"
      }
    }
  }
}

Instructions for getting your API Key can be found here.

‼️ NOTE: ChatGPT does not support custom MCP servers unless you have the Pro Plan ($200/mo). They also do not support our authentication scheme. ‼️

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
    CleanShot 2025-06-25 at 14 35 15@2x
  4. Save your API key and secret
    CleanShot 2025-06-25 at 14 35 15@2x

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

About

Composer's MCP server lets MCP-enabled LLMs like Claude backtest trading ideas and automatically invest in them for you

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%