Typed errors
Every failure has a stable code, such as PRICES_REQUIRED or RATE_LIMITED, and a message that says how to fix it. All codes
Creo API
Build the analyzer into your own product, notebook or agent. Send tickers and weights; get 10 SEC fundamental factor z-scores and percentiles, each holding's contribution, coverage and the as-of date. No prices needed.
# Tickers and weights. No prices; no key needed to try it. curl https://itscreo.com/v1/portfolio/analyze \ -H "x-api-key: $CREO_KEY" \ -H "content-type: application/json" \ -d '{ "positions": [ {"ticker": "AAPL", "weight": 30}, {"ticker": "MSFT", "weight": 25}, {"ticker": "NVDA", "weight": 20}, {"ticker": "JNJ", "weight": 15}, {"ticker": "COST", "weight": 10} ] }'
// 200 OK, a real response as of 2026-11-19, excerpt { "as_of": "2026-11-19", "methodology_version": "creo-sec-fundamental-scores:1.0.0", "headline": "Your book tilts toward large-float, highly profitable companies.", "exposures": [ { "factor_id": "profitability", "exposure": 1.84, "percentile": 94.0, "sentence": "Strong positive tilt: earns more gross profit, net income and operating cash per dollar of assets." }, { "factor_id": "value_float", "exposure": -0.712, "percentile": 21.4, "sentence": "Moderate negative tilt: low book equity and earnings relative to its reported public float." }, "\u2026" ], "holdings": [ { "ticker": "NVDA", "weight": 0.2, "factors": { "profitability": { "z": 2.753, "percentile": 99.7, "label": "very high profitability", "contribution": 0.5506 } } }, "\u2026" ], "coverage": { "holdings": 5, "scored": 5, "unscored": 0, "scored_weight": 1.0 }, "credits": { "plan": "free", "calls_used": 3, "daily_call_limit": 100, "reset_at": "2026-11-20T00:00:00+00:00" } }
// 422, free: no credit is charged { "detail": { "code": "QUANTITY_NEEDS_VALUE", "message": "Creo does not price shares. Send weight or market_value." } } // 400: keys never go in the URL { "detail": { "code": "KEY_IN_QUERY", "message": "API keys in the URL are not accepted because URLs end up in logs. Send the key as the x-api-key header (or Authorization: Bearer)." } }
MCP
Connect Claude, Cursor, Codex or any MCP client to the hosted server. Your agent can
list factors and score portfolios directly. Listed in the official MCP Registry as
com.itscreo/creo.
claude mcp add --transport http creo https://itscreo.com/mcp \ --header "x-api-key: $CREO_KEY"
Built for production
Every failure has a stable code, such as PRICES_REQUIRED or RATE_LIMITED, and a message that says how to fix it. All codes
One successful call is one credit. Each response reports calls used and when the limit resets; errors are never charged. Limits
The reference renders from the live OpenAPI 3.1 schema, so it always matches production. Reference
Every response names its methodology version, and /status reports each data source live.