Function handleFetchUrl

handleFetchUrl(
    id: string | number | null,
    url: string | undefined,
    fetchImpl?: {
        (input: URL | RequestInfo, init?: RequestInit): Promise<Response>;
        (input: string | URL | Request, init?: RequestInit): Promise<Response>;
    },
): Promise<JsonRpcSuccess | JsonRpcError>
JSON-RPC handler for the proxy's fetch_url method.

Validates the requested URL against the IMF allow-list (protocol, hostname, path prefix), forwards it via fetchImpl, and returns the response body wrapped in a JSON-RPC success envelope. Disallowed URLs return a JSON-RPC error envelope rather than throwing.
Parameters
- id: string | number | null
  JSON-RPC request id to echo back in the response.
- url: string | undefined
  Absolute URL the agent is requesting.
- fetchImpl: {
  (input: URL | RequestInfo, init?: RequestInit): Promise<Response>;
  (input: string | URL | Request, init?: RequestInit): Promise<Response>;
  } = globalThis.fetch
  fetch implementation (overridable for tests).
  - (input: URL | RequestInfo, init?: RequestInit): Promise<Response>
    MDN Reference
    
    Parameters
    input: URL | RequestInfo
    Optionalinit: RequestInit
    Returns Promise<Response>
    (input: string | URL | Request, init?: RequestInit): Promise<Response>
    MDN Reference
    
    Parameters
    input: string | URL | Request
    Optionalinit: RequestInit
    Returns Promise<Response>
Returns Promise<JsonRpcSuccess | JsonRpcError>
A JSON-RPC success envelope with the response body, or an error envelope describing why the URL was rejected.
- Defined in mcp/fetch-proxy-server.ts:330

Function handleFetchUrl

Parameters

Parameters

Returns Promise<Response>

Parameters

Returns Promise<Response>

Returns Promise<JsonRpcSuccess | JsonRpcError>

Settings