MCP Plugin Setup
Scan MCP servers directly from Claude Code, Cursor, Windsurf, Gemini CLI, or any MCP client.
Installation
Run directly with uvx (recommended, no install needed):
Or install with pip:
Get an API Key
Sign up at mcpampel.com/register. 50 API calls/day included.
Go to Account and create a new API key. Copy the key starting with sk_live_.
Editor Configuration
Add MCPAmpel to your editor's MCP config. Select your editor below:
Restart your editor after saving the configuration.
HTTP Mode (Custom Agents)
The plugin also supports SSE transport for use with the Agent SDK or any HTTP-based MCP client.
Install with HTTP dependencies
Run in SSE mode
The SSE server listens on all interfaces by default. Use --host 127.0.0.1 to restrict to localhost.
Available Tools
Once configured, the plugin exposes four tools to your MCP client:
- scan_my_servers - Discover all MCP servers in your config and scan them with 16 engines.
- scan_url - Scan a single GitHub, GitLab, npm, or PyPI URL.
- check_status - Show your daily usage and remaining quota.
- get_scan_results - Get full detailed results for a specific scan by its ID.
Example Prompts
Try these prompts after installing the plugin:
Scan all your installed MCP servers
Scan a specific repository
Scan an npm package
Check your quota
Get detailed results
Questions? Check the API Reference or open an issue on GitHub.