Civo MCP Server

Instructions

Implementation Reference

• src/index.ts:345-360 (handler)

  MCP tool handler for 'list_regions': calls listRegions API function and formats the response as text content.

  case 'list_regions': {
    const regions = await listRegions();
    const regionList = regions
      .map((r: any) => `${r.name} (${r.code})`)
      .join('\n');
  
    return {
      content: [
        {
          type: 'text',
          text: `Available Regions:\n${regionList}`,
        },
      ],
      isError: false,
    };
  }

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

  Tool schema definition including name, description, and empty input schema (no parameters required).

  export const LIST_REGIONS_TOOL: Tool = {
    name: 'list_regions',
    description: 'List available regions on Civo',
    inputSchema: {
      type: 'object',
      properties: {},
    },
  };

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

  Registers the list_regions tool in the server's capabilities.tools map.

  [LIST_REGIONS_TOOL.name]: LIST_REGIONS_TOOL,

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

  Core helper function that performs the HTTP request to Civo API to retrieve the list of regions.

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

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

  Includes the list_regions tool in the ListTools response.

  LIST_REGIONS_TOOL,