DocsMCP

Guides

MCP

Connect Claude, Cursor, Codex or any MCP client to Creo's hosted server, and your agent can list factors and score portfolios directly.

Server

Streamable HTTP at https://itscreo.com/mcp. Send your key as the x-api-key header. Only successful scoring costs a credit; connecting, listing tools and errors are free. Clients that browse the official MCP Registry can install it as com.itscreo/creo.

Client setup

Claude Code

claude mcp add --transport http creo https://itscreo.com/mcp --header "x-api-key: $CREO_KEY"

Cursor · ~/.cursor/mcp.json

{
  "mcpServers": {
    "creo": {
      "url": "https://itscreo.com/mcp",
      "headers": { "x-api-key": "creo_..." }
    }
  }
}

Codex · ~/.codex/config.toml

[mcp_servers.creo]
url = "https://itscreo.com/mcp"
http_headers = { "x-api-key" = "creo_..." }

Tools

list_factors

List factor ids, the daily closes each needs, the demo tickers and the methodology version. Free.

mint_api_key

Create a free API key (100 scoring calls a day, 50 positions). Free; limited to 5 keys per IP per day. The key is shown once. Put it in your MCP client config as the x-api-key header, or pass it as the api_key argument of the scoring tools for the rest of this session.

score_demo_portfolio

Score the five labeled SYNTH.* demo tickers. Synthetic series, not market data. Works without a key. Costs 1 credit.

score_portfolio

Compute named factor exposures and risk contribution for positions. You must supply daily close history (volume for liquidity, market_cap for size, benchmark for beta). Creo never fetches prices. Missing exposures stay null with a reason. Needs a key unless every position is a SYNTH.* ticker without history. Costs 1 credit when it succeeds; errors are free.

Errors over MCP

Tool errors use the same body as the REST API, returned as the tool result with isError set. MCP never answers a tool call with HTTP 401 or 429, so your agent can read and act on the code. See Errors.