ShieldAPI MCP

Instructions

Implementation Reference

• src/index.ts:179-187 (registration)

  The tool 'shieldapi.check_ip' is registered dynamically within this loop, utilizing the 'TOOLS' definition map and calling the 'callShieldApi' helper function.

  for (const [name, def] of Object.entries(TOOLS)) {
    server.tool(
      name,
      def.description,
      { [def.param]: z.string().describe(def.paramDesc) },
      { ...readOnlyAnnotations, title: TOOL_TITLES[name] || name },
      async (params) => formatResult(await callShieldApi(def.endpoint, params as Record<string, string>))
    );
  }

• src/index.ts:101-116 (handler)

  This is the generic handler function that executes the API call for 'shieldapi.check_ip' (and other GET tools) by appending the endpoint and query parameters to the SHIELDAPI_URL.

  async function callShieldApi(endpoint: string, params: Record<string, string>): Promise<unknown> {
    const url = new URL(`${SHIELDAPI_URL}/api/${endpoint}`);
    for (const [key, value] of Object.entries(params)) {
      url.searchParams.set(key, value);
    }
    if (demoMode) {
      url.searchParams.set('demo', 'true');
    }
  
    const response = await paymentFetch(url.toString());
    if (!response.ok) {
      const body = await response.text();
      throw new Error(`ShieldAPI ${endpoint} failed (${response.status}): ${body.substring(0, 200)}`);
    }
    return response.json();
  }