Prompt-first / MCP-first free developer service configurator CLI with MCP server support
Baipiao has 13 tools with complete input schemas and descriptions present for all tools and parameters. Naming follows verb_noun convention (search_, get_, generate_, process_, test_, vault_, recommend_, update_). However, descriptions are brief (avg ~60 chars, below the 194-char baseline), lack dependency hints and recovery guidance, and output schemas are not documented. Error handling is minimal, no guidance on retryability, user-fixable vs fatal errors, or recovery paths. Vault tools (vault_set, vault_get, vault_list, vault_health) are well-structured but lack detail on secret handling and validation. The tool composition is sound (each does one thing), but descriptions need expansion to meet LLM-optimization standards.
Generate .env.local and .env.example files from vault entries
Generate a setup prompt for configuring a service with an AI agent
Get current project configuration status
Get detailed information about a specific service by ID or slug
Parse and process agent output to extract service configuration
Get recommended service stack for a project type
Search the free-for-dev service catalog by keyword
Test connection to a configured service
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields (e.g., what does search_services return? field names, structure, pagination info?). Agents must guess or fail.
Descriptions are too brief (avg 60 chars vs 194-char baseline). Missing WHEN to use each tool, dependencies, and recovery hints. E.g., 'Generate a setup prompt' doesn't explain when to call it vs generate_env_files, or what to do with the output.
No error handling guidance. Tools like vault_set, process_agent_output, and test_service_connection can fail, but descriptions don't indicate retryability, user-fixable errors, or recovery paths. Agents cannot self-correct.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Update the configuration state of a service in the project
Retrieve a value from the vault
Check health status of vault entries
List all vault entries with metadata
Store a secret or configuration value in the vault
Vault tools lack secret-handling documentation. vault_set stores secrets but description doesn't clarify encryption, access control, or whether values are masked in logs. Agents need to know if secrets are safe to pass.
No pagination or result-limit documentation. search_services accepts 'limit' but doesn't state max value, default, or what happens if limit is exceeded. Agents may request 10,000 results and blow context window.