Skip to content

Give your agent
a lasting workspace.

MCP server

Connect your preferred MCP client to ENSEMBLE. Let your agent discover assets, build allocation models and inspect stored work through the same platform you use.

Before you connect

You need an ENSEMBLE account and a client that supports remote Streamable HTTP MCP with OAuth or bearer-key authentication. Check your client’s plan, connector access and workspace administrator settings first. A ChatGPT recommendation does not mean every ChatGPT account can connect to ENSEMBLE.

The client notes below describe supported setup paths. An API key belongs in your client’s protected configuration, never in a public prompt or shared transcript.

Remote connector URL
https://api.ensemble.markets/mcp

Connect. Authenticate. Start with a question.

Add the connector

Use a directory link below, or paste the server URL into your client’s remote MCP configuration.

Choose authentication

Use OAuth where your client supports it, or provide an ENSEMBLE API key in the Authorization header.

Discover the tools

Ask the client to inspect the available tools and your workspace before building.

Keep the conversation connected to the work.

“Find ETFs with U.S. equity exposure. Show which metadata and history fields are missing.”

“Inspect my Diversified core model. Explain its universe, inputs and latest allocation.”

“Compare these two model runs. Identify the changed inputs before interpreting their results.”

“Show the source of the optimizer used by this model and explain its assumptions.”

These are example requests. The agent chooses tools and must inspect their results. Builds and runs are metered; connecting a tool does not authorize brokerage execution.

Bring the client you use.

ChatGPT

Public plugin release in preparation; custom development connections depend on host settings.

Claude

Available in the Claude directory. Your plan and workspace settings control connector access.

Cursor

One-click install, or mcp.json with an API key for headless use.

VS Code

GitHub Copilot agent mode — VS Code 1.101+.

Claude Code

Anthropic's terminal agent.

Codex CLI

OpenAI's terminal agent — config.toml with a bearer token.

Gemini CLI

Google's terminal agent.

Windsurf

Cascade MCP servers via mcp_config.json.

Agents

Remote Streamable HTTP MCP clients or SDKs with bearer-header support.

Configuration for header-based clients
{
  "mcpServers": {
    "ensemble": {
      "url": "https://api.ensemble.markets/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

A shared product surface.

Resources
Assets, models, model runs, builds, backfills and optimizers
Transport
Remote Streamable HTTP
Authentication
OAuth 2.1 with PKCE or an ENSEMBLE bearer API key
Discovery
Tools generated from the canonical REST API; reconnect or refresh discovery after updates
Connect your agentRead the API reference