gcp-billing-get-account-details

Retrieve detailed information about a specific Google Cloud billing account to view costs, payment methods, and account settings.

Instructions

Retrieve detailed information about a specific Google Cloud billing account

Input Schema

TableJSON Schema

Name	Required	Description	Default
`billingAccountName`	Yes	Billing account name (e.g., 'billingAccounts/123456-789ABC-DEF012')

Implementation Reference

src/services/billing/tools.ts:132-133 (registration)
Registers the 'gcp-billing-get-account-details' tool with the MCP server instance.
```
server.registerTool(
  "gcp-billing-get-account-details",
```

src/services/billing/tools.ts:138-144 (schema)

Input schema using Zod validation for the required 'billingAccountName' parameter.

inputSchema: {
  billingAccountName: z
    .string()
    .describe(
      "Billing account name (e.g., 'billingAccounts/123456-789ABC-DEF012')",
    ),
},

src/services/billing/tools.ts:146-195 (handler)

Handler function that executes the tool logic: initializes GCP Billing client, calls getBillingAccount API with the provided billingAccountName, maps response to BillingAccount interface, formats using formatBillingAccount helper, and returns markdown-formatted text response. Handles errors with GcpMcpError.

async ({ billingAccountName }) => {
  try {
    const billingClient = getBillingClient();

    logger.debug(
      `Getting billing account details for: ${billingAccountName}`,
    );

    const [account] = await billingClient.getBillingAccount({
      name: billingAccountName,
    });

    if (!account) {
      return {
        content: [
          {
            type: "text",
            text: `Billing account not found: ${billingAccountName}`,
          },
        ],
      };
    }

    const billingAccount: BillingAccount = {
      name: account.name || "",
      displayName: account.displayName || "Unknown",
      open: account.open || false,
      masterBillingAccount: account.masterBillingAccount,
      parent: account.parent,
    };

    const response = formatBillingAccount(billingAccount);

    return {
      content: [
        {
          type: "text",
          text: response,
        },
      ],
    };
  } catch (error: any) {
    logger.error(`Error getting billing account details: ${error.message}`);
    throw new GcpMcpError(
      `Failed to get billing account details: ${error.message}`,
      error.code || "UNKNOWN",
      error.status || 500,
    );
  }
},

src/services/billing/types.ts:245-249 (helper)
Helper function to create and return a configured CloudBillingClient instance used by the tool handler.
```
export function getBillingClient(): CloudBillingClient {
  return new CloudBillingClient({
    projectId: process.env.GOOGLE_CLOUD_PROJECT,
  });
}
```

src/services/billing/types.ts:287-300 (helper)

Helper function to format the retrieved BillingAccount object into a human-readable markdown string for the tool response.

export function formatBillingAccount(account: BillingAccount): string {
  let result = `## ${account.displayName}\n\n`;
  result += `**Account Name:** ${account.name}\n`;
  result += `**Status:** ${account.open ? "✅ Active" : "❌ Closed"}\n`;

  if (account.masterBillingAccount) {
    result += `**Master Account:** ${account.masterBillingAccount}\n`;
  }

  if (account.parent) {
    result += `**Parent:** ${account.parent}\n`;
  }

  return result;

Google Cloud MCP Server