{"schema":"apex-mcp-discovery/1","name":"Apex AI Component Card Store","version":"mcp-server-v1","updatedAt":"2026-07-03T08:16:53.770Z","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":"Help AI agents discover Apex cards, read the current LLM wiki, follow the card use-kit, run the permissionless deflated-sharpe diagnostic, 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/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/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","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","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_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://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"}],"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":"20 calls per IP per hour plus global agent-write protection","sampleInput":{"returns":[0.01,-0.002,0.004,0.006,-0.001],"n_trials":12}},{"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"]}