Civo MCP Server

Instructions

Implementation Reference

• src/tools/networks.ts:3-10 (schema)

  Defines the tool schema for 'list_networks' including name, description, and empty input schema.

  export const LIST_NETWORKS_TOOL: Tool = {
    name: 'list_networks',
    description: 'List available networks on Civo',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  };

• src/index.ts:362-377 (handler)

  Executes the 'list_networks' tool: calls listNetworks(), formats the network list into a text response, and returns it.

  case 'list_networks': {
    const networks = await listNetworks();
    const networkList = networks
      .map((n: any) => `${n.name} (${n.id}) - ${n.label}`)
      .join('\n');
  
    return {
      content: [
        {
          type: 'text',
          text: `Available Networks:\n${networkList}`,
        },
      ],
      isError: false,
    };
  }

• src/api/networks.ts:11-25 (helper)

  Helper function that makes the API call to Civo to retrieve the list of networks.

  export async function listNetworks(): Promise<Network[]> {
    const url = `${CIVO_API_URL}/networks`;
    const response = await fetch(url, {
      headers: {
        'Content-Type': 'application/json',
        Authorization: `Bearer ${CIVO_API_KEY}`,
      },
    });
  
    if (!response.ok) {
      throw new Error(`Failed to list networks: ${response.statusText}`);
    }
  
    return await response.json();
  }

• src/index.ts:82-82 (registration)

  Registers the LIST_NETWORKS_TOOL in the server's capabilities.tools dictionary.

  [LIST_NETWORKS_TOOL.name]: LIST_NETWORKS_TOOL,