Back

Composer MCP

Reach Composer from an LLM client through NEXUS, EventTrader's in-platform AI assistant: ask in natural language and NEXUS calls the compose_instrument tool below on your behalf to assemble a draft, risk-sized tokenized basket for a theme. Composer returns a draft recommendation only (no live trading, nothing bought or sold; not investment advice).

REST API Python SDK MCP Tools Open Composer

How to reach this tool — compose_instrument is a NEXUS assistant tool: use it by asking NEXUS in the in-app chat while signed in, or, agent-to-agent, by registering (POST /mcp/v1/register) and messaging NEXUS. It is not a standalone POST /mcp/v1/tools/{name} call — the public /mcp/v1 tool endpoint serves market-data & trading tools (list_markets, get_orderbook, place_order, …). For direct programmatic access to Composer, use the REST API and SDK.

Connect an LLM Client

https://cymetica.com/mcp/v1

EventTrader exposes a single MCP surface. Connecting an LLM client here lets it talk to NEXUS — which calls the Composer tool below on your behalf — and also gives it the directly-callable market-data & trading tools.

Discovery: GET /.well-known/mcp.json · Direct tools: GET /mcp/v1/tools · Register: POST /mcp/v1/register

For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "eventtrader": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://cymetica.com/mcp/v1"]
    }
  }
}

Tool

Tool	Args	Description
`compose_instrument`	`theme, time_horizon_years, loss_capacity, loss_tolerance, knowledge, liquidity_need`	Assemble a DRAFT, risk-sized tokenized-basket recommendation from a theme + the user's risk answers. Returns a draft only — not tradeable. Requires login.

The natural next step — backtesting the draft as an AI Index Basket — lives on the MacroMarket MCP tools (build_ai_index_basket, backtest_ai_index_basket).

Authentication

Composer acts on behalf of a logged-in user. Use it from the in-app NEXUS chat while signed in, or as a registered agent (POST /mcp/v1/register) messaging NEXUS. The underlying REST endpoint requires a Bearer JWT — see the REST API page.

Example LLM Prompts

"Build me a moderate-risk basket for data center electricity, 5-year horizon."
"I'm a cautious investor — compose a low-risk draft basket for cures for cancer."
"Draft a basket for the space industry and explain why each vehicle fits."

Tool Reference

compose_instrument

{
  "name": "compose_instrument",
  "description": "Assemble a DRAFT tokenized-basket recommendation for the user from a theme they describe and their risk answers. Returns a draft recommendation only — it is NOT yet tradeable and you must not promise returns. Requires login.",
  "inputSchema": {"type":"object","required":["theme","time_horizon_years","loss_capacity","loss_tolerance","knowledge","liquidity_need"],"properties":{
    "theme":{"type":"string","description":"The investment theme to build around"},
    "time_horizon_years":{"type":"integer","description":"Investment horizon in years (>0)"},
    "loss_capacity":{"type":"integer","description":"Ability to bear loss, 1 (cannot) .. 5 (large)"},
    "loss_tolerance":{"type":"integer","description":"Willingness to bear loss, 1 (panic-sell) .. 5 (buy the dip)"},
    "knowledge":{"type":"integer","description":"Investing knowledge, 1 (novice) .. 5 (professional)"},
    "liquidity_need":{"type":"integer","description":"Liquidity need, 1 (need soon) .. 5 (no foreseeable need)"}
  }}
}

Trading Mode

Composer is advisory / draft only — the MCP tool never places a live order, never moves funds, and never mints anything. To paper-trade an idea, hand the draft to MacroMarket's paper_trade_ai_index_basket tool.