{
  "markdown": "# MCPAmpel - MCP Security Scanner\n\n[![MCPAmpel](https://mcpampel.com/badge/MCPAmpel/mcpampel.svg)](https://mcpampel.com/repo/MCPAmpel/mcpampel)\n\nScan your installed MCP servers for security vulnerabilities, directly from your AI agent.\n\nMCPAmpel discovers MCP servers from your Claude Code, Cursor, Windsurf, or Gemini CLI configuration, submits them to 16 scanning engines, and returns an aggregated trust score with detailed findings.\n\n50 API calls/day included.\n\n## Quick Start\n\n```bash\nuvx mcpampel\n```\n\n## Configuration\n\n### Claude Code / Claude Desktop\n\nAdd to `~/.claude/settings.json` or `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcpampel\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcpampel\"],\n      \"env\": {\n        \"MCPAMPEL_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcpampel\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcpampel\"],\n      \"env\": {\n        \"MCPAMPEL_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcpampel\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcpampel\"],\n      \"env\": {\n        \"MCPAMPEL_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Gemini CLI\n\nAdd to `~/.gemini/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mcpampel\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcpampel\"],\n      \"env\": {\n        \"MCPAMPEL_API_KEY\": \"your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Getting an API Key\n\nRegister for free at [mcpampel.com](https://mcpampel.com).\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `MCPAMPEL_API_KEY` | Yes | - | Your API key (free at mcpampel.com) |\n| `MCPAMPEL_BASE_URL` | No | `https://mcpampel.com` | API base URL |\n\n## Tools\n\n### `scan_my_servers`\n\nDiscovers all MCP servers from your editor config and scans them with 16 engines. Returns a summary table with trust scores. No input needed.\n\n### `scan_url`\n\nScan a single GitHub, GitLab, npm, or PyPI URL. Returns trust score, engine breakdown, and findings.\n\n| Parameter | Type | Required |\n|-----------|------|----------|\n| `url` | string | Yes |\n\n### `check_status`\n\nShow your daily quota usage and remaining scans.\n\n### `get_scan_results`\n\nGet detailed results for a specific scan by ID. Use after `scan_my_servers` or `scan_url` to drill into findings.\n\n| Parameter | Type | Required |\n|-----------|------|----------|\n| `scan_id` | string | Yes |\n\n## Development\n\n```bash\ncd mcp-plugin\nuv sync\nuv run pytest\n```\n\n## License\n\nApache License 2.0\n\n---\n\n[mcpampel.com](https://mcpampel.com)\n\n<!-- mcp-name: io.github.MCPAmpel/mcpampel -->\n",
  "bytes": 2731,
  "sha": "580b1bda51872248b5069b312ef3d11ab6a62ef85c90bc6b408dc884be25e0da",
  "repo_slug": "mcpampel/mcpampel",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_diemoeve_mcpampel_5b0e0660/readme"
}