Terrakube MCP Server

Instructions

Implementation Reference

• src/tools/organizations.ts:71-102 (handler)

  The async handler function that executes the tool logic: constructs JSON payload with organization data and sends POST request to API endpoint.

  async ({ name, description = "" }) => {
    const body = JSON.stringify({
      data: {
        type: "organization",
        attributes: {
          name,
          description
        }
      }
    });
  
    const response = await fetch(`${CONFIG.apiUrl}/organization`, {
      method: "POST",
      headers: {
        Authorization: `Bearer ${CONFIG.patToken}`,
        "Content-Type": "application/vnd.api+json"
      },
      body: body
    });
  
    if (response.status === 201) {
      const data = await response.json();
      return {
        content: [{
          type: "text",
          text: JSON.stringify(data, null, 2)
        }]
      };
    } else {
      throw new Error(`Failed to create organization: ${response.statusText}`);
    }
  }

• src/tools/organizations.ts:67-70 (schema)

  Zod input schema defining required 'name' and optional 'description' parameters for the tool.

  {
    name: z.string().describe("Organization name"),
    description: z.string().optional().describe("Organization description")
  },

• src/tools/organizations.ts:64-103 (registration)

  MCP server.tool() call that registers the 'create-organization' tool with its description, schema, and handler.

  server.tool(
    "create-organization",
    "Creates a new organization with the specified name and optional description",
    {
      name: z.string().describe("Organization name"),
      description: z.string().optional().describe("Organization description")
    },
    async ({ name, description = "" }) => {
      const body = JSON.stringify({
        data: {
          type: "organization",
          attributes: {
            name,
            description
          }
        }
      });
  
      const response = await fetch(`${CONFIG.apiUrl}/organization`, {
        method: "POST",
        headers: {
          Authorization: `Bearer ${CONFIG.patToken}`,
          "Content-Type": "application/vnd.api+json"
        },
        body: body
      });
  
      if (response.status === 201) {
        const data = await response.json();
        return {
          content: [{
            type: "text",
            text: JSON.stringify(data, null, 2)
          }]
        };
      } else {
        throw new Error(`Failed to create organization: ${response.statusText}`);
      }
    }
  );

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

  Invocation of registerOrganizationTools in the main server setup, which includes registration of the create-organization tool.

  registerOrganizationTools(server);