{"id":"okx-agent-trade-kit","name":"agent-trade-kit","homepage":null,"repo_url":"https://github.com/okx/agent-trade-kit","category":"ai-ml","subcategories":[],"tags":["ai-agent","crypto-trading","mcp","okx","cli","local-stdio","trading-tools","orders","algo-orders"],"what_it_does":"Provides a local Model Context Protocol (MCP) server and a CLI to connect AI agents/assistants to an OKX account for trading and trading-related operations (market data queries, order management, account/positions, earn, and bots). Keys are configured locally and the MCP server runs as a local stdio process.","use_cases":["Let an AI assistant perform OKX spot/swap/futures/options trading actions via MCP tools","Query market data and technical indicators (no auth required) for agent reasoning","Automate order placement/cancellation/amendment and conditional/algo orders through an agent workflow","Manage account/positions/bills and execute simple earn/bots from an agent","Operate OKX from terminal via the accompanying CLI"],"not_for":["Unattended, fully automated trading without human oversight or robust guardrails","Use as a general-purpose exchange API without understanding OKX risk/constraints","Applications requiring a hosted/sandboxed environment (it is designed for local execution with local keys)","Systems that need a REST/HTTP or Webhook-first integration model"],"best_when":"You want AI tools to execute OKX operations directly from a local agent (Claude Desktop/Cursor/any MCP client) with explicit read-only modes and module-level limiting.","avoid_when":"You cannot securely handle local API keys or you require auditable server-side governance/audit trails managed externally; also avoid if you need standardized HTTP APIs instead of MCP/stdio.","alternatives":["OKX official API + your own integration layer","Other MCP exchange connectors (if available)","Generic trading SDKs/wrappers combined with OpenAI/agent tool calling","Using okx-trade-cli alone without agent/MCP orchestration"],"af_score":75.2,"security_score":70.0,"reliability_score":37.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:43:07.911513+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Local API key configuration via okx config init (OKX credentials for authenticated tools)"],"oauth":false,"scopes":false,"notes":"Authentication is handled by local configuration for trading/account/bot/earn modules. The README indicates a local-only model where keys are stored on the machine; no OAuth flow or explicit scoped delegation is described."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information provided in the supplied README."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":75.2,"security_score":70.0,"reliability_score":37.5,"mcp_server_quality":86.0,"documentation_accuracy":70.0,"error_message_quality":80.0,"error_message_notes":"README includes an example of structured MCP error output (tool name, error type, code, message, endpoint, traceId, timestamp, serverVersion) and asks users to include full error output. However, the provided content does not enumerate error codes or recovery guidance beyond examples/FAQ references.","auth_complexity":80.0,"rate_limit_clarity":55.0,"tls_enforcement":85.0,"auth_strength":70.0,"scope_granularity":55.0,"dependency_hygiene":50.0,"secret_handling":85.0,"security_notes":"README states the MCP server runs locally with API keys stored on the machine and no cloud services/data leaving the device (as claimed). A read-only flag and per-module filtering are safety controls. However, the supplied content does not specify transport/security headers for any local vs upstream requests, nor does it detail dependency/vulnerability status or how secrets are stored/logged internally.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":50.0,"error_recovery":45.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees are described. For trading operations, retries can be risky; the README mentions a built-in rate limiter and read-only mode but does not describe idempotency keys or safe retry semantics.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Trading operations are write actions; an agent may retry after timeouts—without explicit idempotency guidance, this can risk duplicate orders","Models/clients may not respect intended module filtering unless MCP setup/flags are correctly configured","Conditional/algo order parameters must be correct; agents may hallucinate order constraints unless the agent skills/tool schema is followed strictly","Rate limiting exists, but the README does not detail how the client should backoff on 429s/timeouts"]}}