MCP Launchpad (Your gateway to ALL MCPs!)

You have access to the MCP Launchpad (mcpl), a unified CLI for discovering and executing tools from multiple MCP servers. The user may configure and change their MCP configuration at any time. So if your task requires a tool or functionality outside of your current capabilities, it's critical that you always check the MCP Launchpad for available tools that may be useful.

Important: Always Discover Before Calling

Tool names vary between MCP servers. Never guess tool names - always discover them first.

If you're unsure of the tool name, always search first. The mcpl search command is the most efficient way to find relevant tools across all MCP servers.

Recommended Workflow

1. Search first to find the right tool (shows required params):

   mcpl search "list projects"
   

2. Call with required params:

   mcpl call vercel list_projects '{"teamId": "team_xxx"}'
   

Alternative: List Server Tools

If you know which server to use but not the tool name:

mcpl list vercel    # Shows all tools with required params

Get Example Calls

For complex tools, use inspect --example to get a ready-to-use example:

mcpl inspect sentry search_issues --example
# Shows: mcpl call sentry search_issues '{"organizationSlug": "<organizationSlug>", ...}'

Error Recovery

If a tool call fails, mcpl provides helpful suggestions:

• Tool not found: Shows similar tool names from that server
• Missing parameters: Shows required params and an example call
• Validation errors: Shows expected parameter types

Troubleshooting Commands

mcpl verify                 # Test all server connections
mcpl session status         # Check daemon and server connection status
mcpl session stop           # Restart daemon (stops current, auto-restarts on next call)
mcpl config                 # Show current configuration
mcpl call <server> <tool> '{}' --no-daemon  # Bypass daemon for debugging
mcpl auth status            # Check OAuth authentication status
mcpl auth login <server>    # Authenticate with OAuth-protected server

Common Issues

• Server not connecting: Run mcpl verify to test connections
• Stale connections: Run mcpl session stop then retry
• Timeout errors: Server may be slow; increase with MCPL_CONNECTION_TIMEOUT=120
• OAuth authentication required: Run mcpl auth login <server> to authenticate
• Token expired: Run mcpl auth login <server> --force to re-authenticate
• Multiple configs found: Run mcpl config files --select to choose which to use
• Wrong config active: Run mcpl config files to see status and adjust

Quick Reference

# Show help
mcpl --help

# Find tools
mcpl search "<query>"                    # Search all tools (shows required params, returns 5 by default)
mcpl search "<query>" --limit 10         # Get more results
mcpl list                                # List all MCP servers
mcpl list <server>                       # List tools for a server (shows required params)

# Get tool details
mcpl inspect <server> <tool>             # Full schema
mcpl inspect <server> <tool> --example   # Schema + example call

# Execute tools
mcpl call <server> <tool> '{}'                        # No arguments
mcpl call <server> <tool> '{"param": "value"}'        # With arguments

# Verify servers
mcpl verify                              # Test all servers are working

# Config management (when multiple configs exist)
mcpl config files                        # View active/inactive configs
mcpl config files --select               # Interactive selection