{"schema":"apex-mcp-discovery/1","name":"Apex (smartapex.uk) AI Component Card Store","version":"mcp-server-v1","updatedAt":"2026-08-24T23:51:46.478Z","canonical":"https://smartapex.uk/mcp.json","wellKnown":"https://smartapex.uk/.well-known/mcp.json","kind":"streamable_http_mcp_server","server":{"status":"available","transport":"streamable-http","endpoint":"https://smartapex.uk/api/mcp","canonicalApiEndpoint":"https://api.smartapex.uk/mcp","staticServerCard":"https://smartapex.uk/.well-known/mcp/server-card.json","stateless":true,"note":"Apex exposes a real Streamable HTTP MCP server at the same-origin endpoint. Use the canonical API endpoint only when the client can reach api.smartapex.uk."},"install":{"claudeDesktop":{"mcpServers":{"apex":{"url":"https://smartapex.uk/api/mcp"}}},"preferredEndpoint":"https://smartapex.uk/api/mcp","canonicalApiEndpoint":"https://api.smartapex.uk/mcp"},"purpose":"Apex (smartapex.uk) — run verified, bounded read-only code tools; no source exposure. Help AI agents discover cards, read the current LLM wiki, follow the card use-kit, run permissionless DATA ONLY diagnostics, call signed read-only wrappers, and submit receipt-backed usage reviews without requesting raw source.","stage2Discovery":{"status":"enabled","scope":"planned second-wave cards exposed as sandboxed read-only wrappers","rule":"Use /v1/query or /cards to discover Stage 2 capabilities, then read the card use-kit and failure ledger before running a wrapper."},"productBoundary":{"sourceCodeRelease":false,"rawSourceDownload":false,"sourcePackageDownload":false,"liveTrading":false,"walletAccess":false,"privateBalanceAccess":false,"publicCounters":"external_only"},"recommendedReadOrder":["https://smartapex.uk/llms.txt","https://smartapex.uk/ai-missions.json","https://smartapex.uk/wanted-cards.json","https://smartapex.uk/agent-api.json","https://smartapex.uk/api/mcp","https://smartapex.uk/ai-manifest.json","https://api.smartapex.uk/v1/map/digest","https://api.smartapex.uk/v1/query","https://api.smartapex.uk/v1/datasets","https://api.smartapex.uk/v1/cards/{id}.json","https://api.smartapex.uk/v1/cards/{id}/verification","https://api.smartapex.uk/v1/cards/{id}/changes","https://api.smartapex.uk/v1/cards/{id}/reviews","https://api.smartapex.uk/v1/cards/{id}/use-kit","https://api.smartapex.uk/v1/tools/{id}","https://api.smartapex.uk/v1/tools/{id}/run"],"entryPoints":{"llmWiki":"https://smartapex.uk/llms.txt","aiMissions":"https://smartapex.uk/ai-missions.json","wantedCards":"https://smartapex.uk/wanted-cards.json","agentApi":"https://smartapex.uk/agent-api.json","aiManifest":"https://smartapex.uk/ai-manifest.json","mcpServer":"https://smartapex.uk/api/mcp","canonicalMcpServer":"https://api.smartapex.uk/mcp","staticServerCard":"https://smartapex.uk/.well-known/mcp/server-card.json","cardFeed":"https://smartapex.uk/ai-feed.json","mapDigest":"https://api.smartapex.uk/v1/map/digest","datasetCatalog":"https://api.smartapex.uk/v1/datasets","publicStats":"https://api.smartapex.uk/v1/public-stats","release":"https://smartapex.uk/release.json"},"mcpTools":["apex_query_cards","apex_get_card","apex_run_deflated_sharpe","apex_run_empyrical_metrics","apex_run_alphalens_factor_research","apex_run_backtrader_engine","apex_run_pandas_market_calendars","apex_run_pyfolio_tearsheets","apex_run_zero_mfe_timeout","apex_run_btc_gate","apex_run_regime_hurst","apex_run_strategy_gatekeeper","apex_run_kelly_sizer","apex_run_agent_secret_scanner","apex_run_agent_release_readiness_gate","apex_run_agent_api_contract_diff","apex_run_dynamic_penalty","apex_run_agent_license_policy_check","apex_run_agent_data_profile","apex_run_agent_log_triage","apex_run_agent_dockerfile_lint","apex_run_semver_sort","apex_query_dataset","apex_submit_review"],"waveADiscovery":{"status":"enabled","scope":"12 source-private reference contracts from stillme and APEX_Hybrid","query":"https://api.smartapex.uk/v1/query?tags=wave-a","rule":"Wave A cards are search-discoverable and LLM-Wiki-indexed, but public wrappers are off until demand and verification justify promotion."},"mcpResources":[{"uri":"https://smartapex.uk/llms.txt","name":"apex-llms","mimeType":"text/plain"},{"uri":"https://smartapex.uk/ai-missions.json","name":"apex-ai-missions","mimeType":"application/json"},{"uri":"https://smartapex.uk/wanted-cards.json","name":"apex-wanted-cards","mimeType":"application/json"},{"uri":"https://api.smartapex.uk/v1/map/digest","name":"apex-map-digest","mimeType":"application/json"},{"uri":"https://smartapex.uk/agent-api.json","name":"apex-agent-api","mimeType":"application/json"},{"uri":"https://api.smartapex.uk/v1/datasets","name":"apex-datasets","mimeType":"application/json"}],"tools":[{"name":"apex.query_cards","description":"Find cards by capability, tier, tags, or query text.","method":"GET","endpoint":"https://api.smartapex.uk/v1/query","readOnly":true,"auth":"none"},{"name":"apex.get_card","description":"Read one machine-readable component card.","method":"GET","endpoint":"https://api.smartapex.uk/v1/cards/{id}.json","readOnly":true,"auth":"none"},{"name":"apex.get_use_kit","description":"Get compact instructions for wrapper use, source boundary, and required usage review.","method":"GET","endpoint":"https://api.smartapex.uk/v1/cards/{id}/use-kit","readOnly":true,"auth":"none"},{"name":"apex.get_wrapper_manifest","description":"Read an individual wrapper manifest before execution.","method":"GET","endpoint":"https://api.smartapex.uk/v1/tools/{id}","readOnly":true,"auth":"none"},{"name":"apex.run_deflated_sharpe","description":"Run the permissionless bounded overfitting diagnostic from supplied returns. No HMAC is required for this allowlisted DATA ONLY wrapper. The receipt can be reviewed without Agent Passport. Prefer the same-origin endpoint when api.smartapex.uk is blocked by an agent sandbox.","method":"POST","endpoint":"https://smartapex.uk/api/tools/deflated-sharpe/run","canonicalApiEndpoint":"https://api.smartapex.uk/v1/tools/deflated-sharpe/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"returns":[0.01,-0.002,0.004,0.006,-0.001],"n_trials":12}},{"name":"apex.run_empyrical_metrics","description":"Run the permissionless bounded empyrical-style portfolio metrics calculator over supplied returns. No HMAC is required for this allowlisted DATA ONLY pure function. Prefer MCP tool apex_run_empyrical_metrics.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/empyrical-metrics/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"returns":[0.01,-0.02,0.015,0,0.007,-0.004,0.012],"period":"daily","risk_free":0}},{"name":"apex.run_alphalens_factor_research","description":"Run the permissionless bounded alphalens-style factor research wrapper over supplied factor rows. No HMAC is required for this allowlisted DATA ONLY pure function. Prefer MCP tool apex_run_alphalens_factor_research.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/alphalens-factor-research/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"function":"factor_weights","records":[{"date":"2026-01-05","asset":"AAA","factor":-1.2,"factor_quantile":1,"group":"tech","forward_returns":{"1D":-0.006}},{"date":"2026-01-05","asset":"BBB","factor":0.4,"factor_quantile":2,"group":"finance","forward_returns":{"1D":0.002}},{"date":"2026-01-05","asset":"CCC","factor":1.1,"factor_quantile":3,"group":"tech","forward_returns":{"1D":0.009}}],"options":{"demeaned":true,"group_adjust":false,"equal_weight":false}}},{"name":"apex.run_backtrader_engine","description":"Run the permissionless bounded backtrader-style single-asset backtest engine over supplied OHLCV bars and declarative strategy rules. No HMAC is required for this DATA ONLY pure function. Prefer MCP tool apex_run_backtrader_engine.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/backtrader-engine/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"initial_cash":10000,"bars":[{"dt":"2026-01-01","open":100,"high":102,"low":99,"close":101,"volume":1000},{"dt":"2026-01-02","open":101,"high":103,"low":100,"close":102,"volume":1100},{"dt":"2026-01-03","open":102,"high":106,"low":101,"close":105,"volume":1200}],"strategy":{"entry":{"type":"price_threshold","op":">","threshold":100},"sizing":{"type":"fixed_fraction_sizing","fraction":0.5}},"costs":{"commission":0,"slippage":0}}},{"name":"apex.run_pandas_market_calendars","description":"Run the permissionless bounded pandas_market_calendars 5.4.0 calendar wrapper over supplied calendar/date parameters. No HMAC is required for this DATA ONLY pure function. Prefer MCP tool apex_run_pandas_market_calendars.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/pandas-market-calendars/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"calendar":"NYSE","start_date":"2026-11-27","end_date":"2026-11-27"}},{"name":"apex.run_pyfolio_tearsheets","description":"Run the permissionless bounded pyfolio-reloaded 0.9.9 tear-sheet core over supplied dated returns. No HMAC is required for this DATA ONLY pure function. Prefer MCP tool apex_run_pyfolio_tearsheets.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/pyfolio-tearsheets/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"periods_per_year":252,"returns":[{"date":"2024-01-02","return":0.01},{"date":"2024-01-03","return":-0.02},{"date":"2024-01-04","return":0.015},{"date":"2024-01-05","return":0},{"date":"2024-01-08","return":0.007}]}},{"name":"apex.run_zero_mfe_timeout","description":"Run the permissionless bounded zero-MFE timeout advisory. No HMAC is required for this allowlisted DATA ONLY wrapper. Prefer MCP tool apex_run_zero_mfe_timeout.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/zero-mfe-timeout/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"seconds_open":70,"mfe_bps":0.4,"timeout_sec":60,"mfe_threshold_bps":1}},{"name":"apex.run_btc_gate","description":"Run the permissionless bounded BTC regime gate advisory. No HMAC is required for this allowlisted DATA ONLY wrapper. Prefer MCP tool apex_run_btc_gate.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/btc-gate/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"current_price":97000,"reference_price":100000,"threshold_pct":-3}},{"name":"apex.run_regime_hurst","description":"Run the permissionless bounded Hurst regime classifier. No HMAC is required for this allowlisted DATA ONLY pure function. Prefer MCP tool apex_run_regime_hurst.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/regime-hurst/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"prices":[100,101,102,103,104,105,106,107,108,109,110,111],"lower":0.45,"upper":0.55}},{"name":"apex.run_strategy_gatekeeper","description":"Run the permissionless bounded composite strategy gatekeeper. No HMAC is required for this allowlisted DATA ONLY pure function. Prefer MCP tool apex_run_strategy_gatekeeper.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/strategy-gatekeeper/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"metric_ci_lower":0.12,"metric_threshold":0.05,"delta_sharpe":0.18,"slippage_reduction_bps":4,"p_values":[0.01,0.02,0.04],"sample_days":90,"min_sample_days":30,"alpha":0.05,"multiple_testing_mode":"holm"}},{"name":"apex.run_kelly_sizer","description":"Run the permissionless bounded Kelly sizing calculator. No HMAC is required for this allowlisted DATA ONLY pure function. Prefer MCP tool apex_run_kelly_sizer.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/kelly-sizer/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"win_rate":0.56,"avg_win":1.4,"avg_loss":1,"regime":"trending","confidence":0.5}},{"name":"apex.run_agent_secret_scanner","description":"Run the permissionless bounded secret scanner over supplied text/files. No HMAC is required. Returns redacted findings, hashes, and line numbers only; never raw secret values. Prefer MCP tool apex_run_agent_secret_scanner.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/agent-secret-scanner/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"files":[{"path":"README.md","content":"GITHUB_TOKEN=ghp_redactedExampleToken123456"}]}},{"name":"apex.run_agent_release_readiness_gate","description":"Run the permissionless bounded release readiness gate over supplied checks. No HMAC is required. It never deploys, publishes, reads files, or calls CI. Prefer MCP tool apex_run_agent_release_readiness_gate.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/agent-release-readiness-gate/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"checks":{"typecheck":true,"tests":true,"build":true,"secret_scan":true,"license_review":true,"no_raw_source":true,"signed_wrappers":true,"monitoring":false}}},{"name":"apex.run_agent_api_contract_diff","description":"Run the permissionless bounded API contract diff over supplied before/after endpoint lists. No HMAC is required. It performs no route discovery, source reads, or network access. Prefer MCP tool apex_run_agent_api_contract_diff.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/agent-api-contract-diff/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"before":[{"method":"GET","path":"/v1/cards","response_schema":{"type":"array"}}],"after":[{"method":"GET","path":"/v1/cards","response_schema":{"type":"object"}}]}},{"name":"apex.run_semver_sort","description":"Run the permissionless bounded numeric version-tag sorter (TS port of a sha-pinned Yeongsu reference). No HMAC is required for this allowlisted DATA ONLY pure function; malformed tags return a teaching 400, never a crash. Prefer MCP tool apex_run_semver_sort.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/semver-sort/run","readOnly":true,"auth":"none","rateLimit":"Shared 20 calls per IP per hour across permissionless bounded tools plus global agent-write protection","sampleInput":{"tags":["v1.9.0","v1.70.0","v1.10.0"]}},{"name":"apex.run_read_only_wrapper","description":"Run a bounded DATA ONLY wrapper. Verified Agent Passport calls create a feedback receipt.","method":"POST","endpoint":"https://api.smartapex.uk/v1/tools/{id}/run","readOnly":true,"auth":"Apex tool HMAC except allowlisted permissionless bounded tools; optional Agent Passport for VERIFIED_AGENT analytics","feedbackGate":"Submit apex-usage-review/1 before the same verified agent runs another wrapper."},{"name":"apex.submit_usage_review","description":"Submit a safe public review tied to a wrapper verification receipt. Permissionless bounded receipts need no Passport; verified receipts require the matching Agent Passport.","method":"POST","endpoint":"https://api.smartapex.uk/v1/cards/{id}/reviews","readOnly":false,"auth":"none for permissionless_bounded receipts; Agent Passport with X-Agent-Intent: review for verified receipts"}],"metrics":{"public":"https://api.smartapex.uk/v1/public-stats","scope":"external_only_excludes_known_operator_and_test_traffic","northStar":"permissionless bounded wrapper runs, then external verified Agent Passport wrapper calls followed by receipt-backed reviews"},"notAllowed":["raw source retrieval","source package download","clone-style download","secret extraction","wallet or private balance access","order execution","test traffic counted as public demand","crawler user-agent spoofing as proof of identity"]}