GIA MCP Server

Instructions

Implementation Reference

• src/proxy.ts:150-171 (registration)

  Registration of gia_system_status tool in disconnected mode. This is a fallback that returns the tool with a disconnected message when the upstream GIA server is not reachable. The tool is only defined locally for health checks and tool listing when disconnected.

  // When disconnected, return empty results for discovery methods
  // so health checks and tool listing still work
  if (!upstreamConnected || !upstream) {
    const disconnectedMsg = `[GIA disconnected] Connect to ${serverUrl} with a valid GIA_API_KEY to enable tools.`;
    switch (method) {
      case 'tools/list':
        return { tools: [{ name: 'gia_system_status', description: disconnectedMsg, inputSchema: { type: 'object', properties: {} } }] };
      case 'resources/list':
        return { resources: [] };
      case 'resources/templates/list':
        return { resourceTemplates: [] };
      case 'prompts/list':
        return { prompts: [] };
      case 'logging/setLevel':
        return {};
      default:
        throw new Error(
          'GIA upstream server is not reachable. Check your GIA_API_KEY and network connection. ' +
          `Server URL: ${serverUrl}`
        );
    }
  }

• src/proxy.ts:130-179 (handler)

  The fallback request handler that proxies all tool calls (including gia_system_status) to the upstream GIA server. Lines 173-178 show how tools/call requests are forwarded to the upstream server via HTTPS. The actual gia_system_status implementation lives on the upstream server (gia.aceadvising.com), not in this proxy codebase.

  // ── Bridge: forward requests to upstream (or return error if disconnected) ──
  local.fallbackRequestHandler = async (request: JSONRPCRequest) => {
    const method = request.method;
    const params = request.params ?? {};
    const schema = RESULT_SCHEMAS[method];
  
    if (!schema) {
      throw new Error(`Unsupported method: ${method}`);
    }
  
    // Ping always succeeds locally — keeps the server alive for health checks
    if (method === 'ping') {
      return {};
    }
  
    if (!upstreamConnected || !upstream) {
      // Try to reconnect on demand
      await connectUpstream(apiKey, serverUrl);
    }
  
    // When disconnected, return empty results for discovery methods
    // so health checks and tool listing still work
    if (!upstreamConnected || !upstream) {
      const disconnectedMsg = `[GIA disconnected] Connect to ${serverUrl} with a valid GIA_API_KEY to enable tools.`;
      switch (method) {
        case 'tools/list':
          return { tools: [{ name: 'gia_system_status', description: disconnectedMsg, inputSchema: { type: 'object', properties: {} } }] };
        case 'resources/list':
          return { resources: [] };
        case 'resources/templates/list':
          return { resourceTemplates: [] };
        case 'prompts/list':
          return { prompts: [] };
        case 'logging/setLevel':
          return {};
        default:
          throw new Error(
            'GIA upstream server is not reachable. Check your GIA_API_KEY and network connection. ' +
            `Server URL: ${serverUrl}`
          );
      }
    }
  
    const result = await (upstream as any).request(
      { method, params },
      schema
    );
  
    return result;
  };