{"id":"hightemp-go-mcp-server-tinvest","name":"go_mcp_server_tinvest","homepage":null,"repo_url":"https://github.com/hightemp/go_mcp_server_tinvest","category":"ai-ml","subcategories":[],"tags":["mcp","go","tinkoff","trading","market-data","sse","investment-api"],"what_it_does":"A lightweight MCP server in Go that integrates with the Tinkoff Invest API, exposing tools for searching instruments, placing market buy/sell orders, retrieving portfolio state, and getting market data (last price, order book, candles, trading status). It can run over MCP stdio and also includes an SSE HTTP server mode.","use_cases":["Trading assistants that need tool-based access to search instruments and place orders","Portfolio viewers via an MCP tool (current portfolio state)","Market data enrichment for agents (last price, order book depth, historical candles, trading status)","Building agent workflows that call typed MCP tool inputs/outputs to interact with Tinkoff Invest"],"not_for":["Production-grade brokerage execution without additional safeguards (risk checks, order confirmation, idempotency, and audit controls)","Users who cannot securely manage an API token and account id","Use cases requiring strict compliance/audit controls without further review"],"best_when":"When you want to prototype or automate agent-driven research/trading workflows against Tinkoff Invest using a local MCP server and are comfortable adding your own safety and reliability layers.","avoid_when":"When you need strong, documented operational guarantees (SLA, retries/idempotency semantics) or when you cannot ensure secure handling of brokerage credentials.","alternatives":["Direct calls to the Tinkoff Invest API from your own service (no MCP layer)","Other community MCP servers or wrappers for brokerage/market data","Building a REST wrapper around Tinkoff Invest and integrating it into your agent platform"],"af_score":50.8,"security_score":49.0,"reliability_score":18.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T21:20:28.900714+00:00","interface":{"has_rest_api":true,"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":["TINKOFF_TOKEN environment variable (broker API token)"],"oauth":false,"scopes":false,"notes":"Authentication is by providing a Tinkoff API token via environment variables; README mentions error codes like Unauthenticated 40003 when environment does not match (production vs sandbox) and NotFound 50004 when account id is incorrect."},"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 is provided for the MCP server itself; costs would primarily come from Tinkoff Invest API usage and your hosting."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":50.8,"security_score":49.0,"reliability_score":18.8,"mcp_server_quality":70.0,"documentation_accuracy":55.0,"error_message_quality":null,"error_message_notes":"Documentation describes expected brokerage failures for token/account mismatch, but does not specify MCP transport-level or tool-level error schema, codes, or recovery guidance.","auth_complexity":75.0,"rate_limit_clarity":0.0,"tls_enforcement":80.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":35.0,"secret_handling":50.0,"security_notes":"Uses an API token and account id via environment variables. README does not describe how the server logs secrets (assumed to be handled via env usage, but not proven). No mention of fine-grained scopes, IP allowlisting, TLS/HTTP security specifics beyond Tinkoff endpoint using :443, or operational controls for safe order placement. Buy/sell are market orders, which increases risk if an agent misbehaves.","uptime_documented":0.0,"version_stability":20.0,"breaking_changes_history":20.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":"No idempotency or deduplication semantics described for trading actions (buy/sell).","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Placing buy/sell sends market orders and the server determines which account/choice applies (as per environment variables); agents may place irreversible orders if not safeguarded.","Token and endpoint must match the intended environment (production vs sandbox) or Unauthenticated 40003 may occur.","Portfolio requires a correct TINKOFF_ACCOUNT_ID or will fail (NotFound 50004).","candles output is limited to the first 50 candles for compactness (agents may assume full range unless they handle truncation).","orderbook depth is constrained to 1–50; agents should validate depth inputs."]}}