{"id":"smithery-ai-cli","name":"cli","homepage":"https://smithery.ai","repo_url":"https://github.com/smithery-ai/cli","category":"devtools","subcategories":[],"tags":["cli","mcp","model-context-protocol","typescript","oauth","developer-tools","skills-registry"],"what_it_does":"@smithery/cli is a Node/NPX command-line tool that lets you authenticate to Smithery, search/add/list/remove MCP server connections, browse MCP tools, install/score “skills” from a Smithery registry, and mint OAuth/service tokens.","use_cases":["Manage MCP server connections from the command line","Discover and call tools exposed by connected MCP servers","Browse/install Smithery skills for agent use","Upvote/downvote and review skills","Create service tokens with optional JSON policy restrictions"],"not_for":["Building a production server-side integration (CLI-only ergonomics)","Environments that require a documented REST/GraphQL API contract for automation","High-security environments that require detailed guarantees about token storage/logging without code audit"],"best_when":"You want quick developer workflow access to MCP servers/tools and a registry of skills from a local machine or CI job with OAuth/service tokens.","avoid_when":"You need stable machine-to-machine integration via documented web APIs, or you cannot tolerate unclear operational details (rate limits, error codes, retry/idempotency semantics) that are not described in the provided README.","alternatives":["Direct MCP client implementations (where available)","Using Smithery’s APIs (if you have/obtain an API spec) instead of the CLI","Other MCP server registries/connectors and/or custom scripts"],"af_score":41.5,"security_score":57.2,"reliability_score":30.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:24:07.234262+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":["smithery auth login (OAuth)","smithery auth logout","smithery auth whoami","smithery auth token","smithery auth token --policy '<json>'"],"oauth":true,"scopes":false,"notes":"Auth is described at the CLI level (OAuth login + token minting with optional JSON policy). Provided content does not describe scope granularity explicitly."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Pricing details not present in the provided README/repo metadata."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":41.5,"security_score":57.2,"reliability_score":30.0,"mcp_server_quality":55.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":70.0,"rate_limit_clarity":0.0,"tls_enforcement":80.0,"auth_strength":75.0,"scope_granularity":35.0,"dependency_hygiene":50.0,"secret_handling":40.0,"security_notes":"Uses OAuth login and service tokens with an optional JSON policy, which suggests some restriction capability. However, provided materials do not document token storage location, redaction/logging behavior, TLS/error handling for token operations, or explicit scope granularity/rate-limit details. Security scores reflect limited observability from the README alone.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":40.0,"error_recovery":25.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"page parameter shown for skill search (e.g., --page 2); other commands unspecified","retry_guidance_documented":false,"known_agent_gotchas":["CLI commands are convenient for humans but may be less robust than a documented machine API for agent automation","Tool calling requires correct argument serialization; the README only provides a simple JSON example","Idempotency/retry semantics for ‘add/remove/publish’ operations are not described"]}}