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_factorsList factor ids, the daily closes each needs, the demo tickers and the methodology version. Free.
mint_api_keyCreate 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_portfolioScore the five labeled SYNTH.* demo tickers. Synthetic series, not market data. Works without a key. Costs 1 credit.
score_portfolioCompute 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.