{"id":"amxv-terminal-mcp","name":"terminal-mcp","homepage":null,"repo_url":"https://github.com/amxv/terminal-mcp","category":"devtools","subcategories":[],"tags":["mcp","cli","model-context-protocol","terminal","automation","agent-integration"],"what_it_does":"terminal-mcp (tmcp) is a minimal terminal CLI client for Model Context Protocol (MCP) servers. It can connect to MCP servers via stdio (local) or via streamable HTTP (remote), discover tools from configured servers, generate a tools.json allowlist, and let agents list and call only enabled tools via terminal commands.","use_cases":["Enable coding agents (e.g., Codex) to use MCP tools from servers that don’t have native MCP support","Tool discovery and allowlisting via tmcp init + tools.json generation","Remote MCP access by configuring server URLs and custom headers","Controlled execution of pre-configured MCP tools for agent workflows"],"not_for":["Running untrusted/auto-discovered MCP servers without an explicit allowlist","Applications needing a full programmable REST/GraphQL API surface instead of a CLI wrapper","Use cases requiring OAuth flows (explicitly noted as not supported)"],"best_when":"You want a simple, agent-friendly way to call MCP tools with an explicit allowlist (enabled tools only) and minimal runtime dependencies.","avoid_when":"You need first-class OAuth authorization, fine-grained audit logging guarantees, or standardized HTTP API contracts (OpenAPI) for programmatic integration beyond the CLI.","alternatives":["Use an MCP-capable agent/runtime directly (SDK/native MCP clients)","Build/consume MCP clients using @modelcontextprotocol/sdk in your own service","Use other community MCP CLI wrappers or IDE integrations that manage MCP tool access"],"af_score":49.5,"security_score":55.2,"reliability_score":20.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T19:33:39.460160+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":true,"sdk_languages":["JavaScript/TypeScript (implied by npm deps)"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Custom HTTP headers for MCP server requests (per-server headers)","Environment variables (noted as supported for configuration)"],"oauth":false,"scopes":false,"notes":"Auth is described as custom headers and env vars; OAuth is explicitly not supported. Scope granularity appears to be primarily at the tool allowlist level (enabled/disabled), not at OAuth scopes."},"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; project appears to be distributed as code/CLI (MIT). Any costs would come from your MCP servers or external services you connect to."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":49.5,"security_score":55.2,"reliability_score":20.0,"mcp_server_quality":60.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":55.0,"rate_limit_clarity":10.0,"tls_enforcement":80.0,"auth_strength":55.0,"scope_granularity":50.0,"dependency_hygiene":50.0,"secret_handling":40.0,"security_notes":"The README highlights an 'agent-safe binary' allowlisting behavior (only listing/calling enabled preconfigured tools) and blocks developer operations (init/direct/upgrade/configpath) in that mode, which is a meaningful safety control for agent use. Authentication is limited to custom headers/env vars (no OAuth). The README does not describe TLS enforcement details, secret redaction, audit logs, or rate-limit handling; secret-handling score is therefore reduced. Dependency hygiene can’t be fully verified from provided data (only that @modelcontextprotocol/sdk is used).","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":0.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":"init generates tools.json; repeated runs may overwrite/refresh configuration outputs. No explicit idempotency guarantees described.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Agents must format tool parameters as valid JSON strings and follow tool alias naming (server__tool-name).","If tool outputs are large, the CLI claims to enforce line-size limits; still, tool parameter/result formatting issues can break calls.","Remote MCP calls may require correct custom headers/env vars; OAuth is not supported.","The agent-safe binary blocks init/direct/upgrade/config switching; ensure your setup script installs the correct binary for the intended capability set."]}}