{"id":"alaeddinemessadi-opencode-mcp","name":"opencode-mcp","homepage":"https://www.npmjs.com/package/opencode-mcp","repo_url":"https://github.com/AlaeddineMessadi/opencode-mcp","category":"devtools","subcategories":[],"tags":["mcp","opencode","ai-tools","ai-coding","developer-tools","typescript","stdio","automation"],"what_it_does":"opencode-mcp is an MCP server that bridges MCP clients (via stdio) to the OpenCode headless API over HTTP. It auto-starts an OpenCode server when needed and exposes 79 tools, 10 resources, and 6 prompts for delegating coding, debugging, and project/session operations.","use_cases":["Delegating coding tasks (implement features, refactor, debugging) to OpenCode from an MCP-capable AI client","Running multi-step session workflows (create session, run tasks, poll/check status, review diffs)","Using MCP resources to read project/config/provider/health/session state"],"not_for":["Directly serving end-user web/API traffic (it is an MCP bridge for AI tools)","Use cases requiring strict data residency/compliance guarantees not documented here","Environments where starting background processes automatically (auto-serve) is disallowed"],"best_when":"You have an MCP-capable coding assistant and want one consistent tool surface to control OpenCode sessions across multiple projects/directories.","avoid_when":"You cannot control or secure access to the local OpenCode server / auto-start process, or you need explicit, documented rate limit and retry/idempotency semantics for safe automation.","alternatives":["Use OpenCode client tooling directly (without MCP)","Write a custom MCP bridge that exposes only the minimal required OpenCode actions","Use another MCP integration specific to your preferred coding agent/provider"],"af_score":62.5,"security_score":51.0,"reliability_score":28.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:35:17.868693+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":["HTTP basic auth to the OpenCode server (OPENCODE_SERVER_USERNAME/OPENCODE_SERVER_PASSWORD)","Provider/auth handled by the downstream OpenCode server (tooling includes Provider & Auth tools, but exact auth mechanism for OpenCode is not detailed here)"],"oauth":false,"scopes":false,"notes":"Authentication described pertains to the OpenCode server URL used by this bridge (optional HTTP basic auth when OPENCODE_SERVER_PASSWORD is set). No OAuth flows/scopes are described for this MCP layer itself."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Pricing not described in the provided README/content; OpenCode provider costs would likely apply but are not stated here."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":62.5,"security_score":51.0,"reliability_score":28.8,"mcp_server_quality":85.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":70.0,"rate_limit_clarity":20.0,"tls_enforcement":55.0,"auth_strength":60.0,"scope_granularity":30.0,"dependency_hygiene":60.0,"secret_handling":50.0,"security_notes":"TLS is not explicitly enforced here; default OPENCODE_BASE_URL uses http://127.0.0.1:4096 (may still be safe locally but is not evidence of HTTPS). Authentication is optional via HTTP basic auth; no fine-grained scopes described at this MCP layer. The bridge can start/drive code execution/workflows via OpenCode, so treat it as high-privilege automation—ensure the OpenCode server is secured and limit who/what can connect to the MCP stdio process.","uptime_documented":0.0,"version_stability":50.0,"breaking_changes_history":30.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees documented for tools like run/fire/session operations; some operations appear stateful (session creation, code execution), so callers should assume non-idempotent behavior unless the underlying OpenCode API specifies otherwise.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Auto-start behavior: the server may start opencode serve automatically if not running (OPENCODE_AUTO_SERVE=true by default), which can be surprising in locked-down environments.","Stateful sessions: prefer workflow tools (setup/run/wait/check) to maintain consistent session state; mixing fire/run/reply without sessionId tracking can lead to confusing outcomes.","Directory targeting: tools accept an optional directory for multi-project support; ensure the correct path is provided to avoid modifying the wrong project.","Error semantics: no explicit standardized error codes/retry guidance described in the provided content; agents should be prepared for upstream HTTP/API errors from OpenCode."]}}