get_pricing

Instructions

Implementation Reference

• src/tools/billing.ts:43-70 (handler)

  The handler function for the 'get_pricing' tool. Registered via server.registerTool('get_pricing', ...), it calls api.pricing() and returns the result. No auth required.

    // --- get_pricing ---
    // No auth required
    server.registerTool(
      "get_pricing",
      {
        description: `Show available pipeline check credit packages and pricing. Returns all packages with credit counts and prices.
  
  Packages (one-time purchase, no subscription):
  - Starter: 100 credits for $9 ($0.09 each)
  - Standard: 500 credits for $39 ($0.078 each)
  - Pro: 2,000 credits for $99 ($0.0495 each)
  - Scale: 10,000 credits for $399 ($0.0399 each)
  
  Most URL lookups are free (known domains and cached domains). Credits are only consumed when an unknown domain runs through the full analysis pipeline. In typical use, 95-99% of URLs resolve free.
  
  This tool does not require an API key.`,
        inputSchema: {},
      },
      async () => {
        try {
          const result = await api.pricing();
          return successResult(result);
        } catch (err) {
          if (err instanceof ApiRequestError) return apiErrorToResult(err);
          return errorResult(err instanceof Error ? err.message : "Unknown error");
        }
      }
    );

• src/tools/billing.ts:43-70 (schema)

  Schema for get_pricing: inputSchema is empty (no input params), description describes the available credit packages.

    // --- get_pricing ---
    // No auth required
    server.registerTool(
      "get_pricing",
      {
        description: `Show available pipeline check credit packages and pricing. Returns all packages with credit counts and prices.
  
  Packages (one-time purchase, no subscription):
  - Starter: 100 credits for $9 ($0.09 each)
  - Standard: 500 credits for $39 ($0.078 each)
  - Pro: 2,000 credits for $99 ($0.0495 each)
  - Scale: 10,000 credits for $399 ($0.0399 each)
  
  Most URL lookups are free (known domains and cached domains). Credits are only consumed when an unknown domain runs through the full analysis pipeline. In typical use, 95-99% of URLs resolve free.
  
  This tool does not require an API key.`,
        inputSchema: {},
      },
      async () => {
        try {
          const result = await api.pricing();
          return successResult(result);
        } catch (err) {
          if (err instanceof ApiRequestError) return apiErrorToResult(err);
          return errorResult(err instanceof Error ? err.message : "Unknown error");
        }
      }
    );

• src/tools/billing.ts:15-18 (registration)

  The registerBillingTools function that registers get_pricing (along with get_balance and purchase) on the MCP server.

  export function registerBillingTools(
    server: McpServer,
    api: UnphurlAPI
  ): void {

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

  Top-level registration call: registerBillingTools(server, api) wires up get_balance, get_pricing, and purchase tools.

  registerBillingTools(server, api); // get_balance, get_pricing, purchase

• src/api.ts:191-193 (helper)

  The api.pricing() method called by the handler — makes a GET request to /v1/pricing (public, no auth needed).

  async pricing(): Promise<PricingResponse> {
    return this.doRequest<PricingResponse>("GET", "/v1/pricing");
  }