BerriAI/litellm · error · HTTPException

MCP registry is not enabled

Error message

MCP registry is not enabled

What it means

Feature-flag guard on GET /v1/mcp/registry.json: the MCP registry endpoint was requested but the registry feature is not enabled in the proxy config, so there is no registry document to serve. Fires regardless of caller permissions.

Source

Thrown at litellm/proxy/management_endpoints/mcp_management_endpoints.py:941

        "/network/client-ip",
        tags=["mcp"],
        dependencies=[Depends(user_api_key_auth)],
        description="Returns the caller's IP address as seen by the proxy.",
    )
    async def get_client_ip(request: Request):
        from litellm.proxy.auth.ip_address_utils import IPAddressUtils

        client_ip: Final = IPAddressUtils.get_mcp_client_ip(request)
        return {"ip": client_ip}

    @router.get(
        "/registry.json",
        tags=["mcp"],
        description="MCP registry endpoint. Spec: https://github.com/modelcontextprotocol/registry",
    )
    async def get_mcp_registry(request: Request):
        if not _is_public_registry_enabled():
            raise HTTPException(
                status_code=status.HTTP_404_NOT_FOUND,
                detail="MCP registry is not enabled",
            )

        from litellm.proxy.auth.ip_address_utils import IPAddressUtils

        client_ip: Final = IPAddressUtils.get_mcp_client_ip(request)

        verbose_proxy_logger.debug("MCP registry request from IP=%s", client_ip)

        base_url: Final = get_request_base_url(request)
        registry_servers: Final[list[dict[str, _McpRegistryEntry]]] = []
        registry_servers.append({"server": _build_builtin_registry_entry(base_url)})

        # Centralized IP-based filtering: external callers only see public servers
        registered_servers: Final = list(global_mcp_server_manager.get_filtered_registry(client_ip).values())

        registered_servers.sort(key=_build_mcp_registry_server_name)

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Enable the MCP registry in the proxy configuration.
2. Use config.yaml-declared MCP servers if the registry is intentionally disabled.

When it happens

Trigger: Thrown at litellm/proxy/management_endpoints/mcp_management_endpoints.py:941 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/33161701603e5bd7. Report an issue: GitHub.