Send your project context to the proxy. It will activate the most relevant MCP servers from the catalogue and return a summary of available tools.

Args: tech_stack: Languages and frameworks in use, e.g. ["python", "fastapi", "postgres"] task_description: Free-text description of what you are working on open_files: File paths currently open in the IDE (optional, helps infer stack) requirements: Package names from requirements.txt / package.json (optional)

List all currently mounted MCP servers and their estimated tool counts.

List MCP servers in the catalogue that are not yet mounted.

Args: filter_tag: Optional tag filter, or free-text query (uses search_servers for discovery).

Search the catalogue for relevant servers/tools using free-text query. Enables on-demand discovery (lazy loading pattern) so the AI can find specific capabilities without the full catalogue bloating context.

Returns ranked list of matching servers (name, desc, score, tags). Use proxy_activate_server on results, or let handshake do it.

Inspired by MCP tool search / lazy discovery best practices (Anthropic, Stacklok, etc.).

List all registered tools by inspecting the FastMCP instance. If server_name is provided, filters for tools from that child server.

Diagnostic tool: Expose proxy state and server counts.

Generate an MCP server from an OpenAPI/GraphQL spec and activate it.

Args: name: A unique name for this generated server spec_url: URL to the OpenAPI spec (JSON/YAML) or GraphQL endpoint spec_type: 'openapi' or 'graphql' eager: If True, mount the server immediately lean: If True, attempt to use LAP (https://lap.sh) to produce a dramatically leaner input spec before 40mcp generation (F-12 research slice). Falls back gracefully if LAP CLI not available.

Activate (mount) a server from the catalogue by name.

By default the server is registered as a deferred stub ({name}_load tool) and only fully spawned when first used. Pass eager=True to mount immediately.

Args: name: Server name as shown in proxy.list_available_servers() eager: If True, spawn the subprocess immediately instead of deferring.

Deactivate (unmount) a currently loaded or pending server to free up tool budget.

Args: name: Server name as shown in proxy.list_active_servers()

Register a custom (non-catalogue) MCP server and optionally activate it. Only SSE and HTTP runtimes are accepted; stdio is restricted to prevent arbitrary command execution.

Args: name: A unique identifier for this server url: SSE URL (e.g. http://localhost:8100/sse) or HTTP URL tags: Tag list for future discovery matching runtime: "sse" or "http" (stdio is not permitted for custom proxies) activate_now: If True, mount the server immediately

Return live process metrics for the proxy itself. Mirrors the mcp://proxy/health resource as a callable tool.

Return current server usage counts for self-evolving ranking (F-13).

Reset usage stats (all or for one server). Useful for testing or re-baselining.