#!/usr/bin/env python3 """List every tool a provider bundle's remote MCP servers offer, with read-only hints. Use it to review allowlists: only list tools; this never calls one. Usage: .venv/bin/python scripts/list-mcp-tools.py [provider] [--json] [--no-auth] --no-auth lists without credentials; Google Cloud MCP servers allow tools/list anonymously. """ from __future__ import annotations import asyncio import json import sys from pathlib import Path from typing import Any sys.path.insert(0, str(Path(__file__).resolve().parents[1])) from execution_engine.config import get_settings from execution_engine.providers import load_provider from execution_engine.tools.mcp import McpClient, NoAuth, auth_from_config async def main(provider: str, as_json: bool, no_auth: bool) -> int: bundle = load_provider(provider) auth = ( NoAuth() if no_auth else auth_from_config(bundle.mcp_auth, get_settings().MCP_QUOTA_PROJECT) ) report: dict[str, dict[str, Any]] = {} for server in bundle.mcp_servers.values(): try: tools = await McpClient(server, auth, timeout=30).list_tools() except Exception as exc: # noqa: BLE001 - report every server report[server.id] = { "url": server.url, "error": f"{type(exc).__name__}: {exc}", } continue report[server.id] = { "url": server.url, "tools": [ { "name": tool.name, "read_only": tool.read_only, "allowed": tool.name in server.allow, "description": tool.description.split("\n")[0][:200], } for tool in tools ], } if as_json: print(json.dumps(report, indent=2)) return 0 for server_id, entry in report.items(): print(f"\n== {server_id} ({entry['url']})") if "error" in entry: print(f" ERROR {entry['error'][:200]}") continue for tool in entry["tools"]: flag = "RO" if tool["read_only"] else "RW" allowed = "allowed" if tool["allowed"] else "" print(f" [{flag}] {tool['name']:<40} {allowed:<8} {tool['description']}") return 0 if __name__ == "__main__": args = [a for a in sys.argv[1:] if not a.startswith("--")] sys.exit( asyncio.run( main( args[0] if args else "gcp", "--json" in sys.argv, "--no-auth" in sys.argv, ) ) )