`stripe_get_customer`

Pack: stripe_connect · Endpoint: https://gateway.pipeworx.io/stripe_connect/mcp

Get a Stripe customer by ID.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Stripe secret or restricted API key (sk_…)
`id`	string	yes	Customer ID (cus_…)

Example call

Arguments

{
  "_apiKey": "your-stripe_connect-api-key",
  "id": "cus_ABC123"
}

curl

curl -X POST https://gateway.pipeworx.io/stripe_connect/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"stripe_get_customer","arguments":{"_apiKey":"your-stripe_connect-api-key","id":"cus_ABC123"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('stripe_get_customer', {
  "_apiKey": "your-stripe_connect-api-key",
  "id": "cus_ABC123"
});

Response shape

Field	Type	Description
`id`	string	Customer ID
`object`	string	Object type (customer)
`address`	object \| null	Customer address
`balance`	integer	Account balance in cents
`created`	integer	Creation timestamp
`currency`	string \| null	Customer currency
`default_source`	string \| null	Default payment source ID
`delinquent`	boolean	Account delinquent status
`description`	string \| null	Customer description
`discount`	object \| null	Applied discount
`email`	string \| null	Customer email
`invoice_prefix`	string	Invoice prefix
`invoice_settings`	object	Invoice settings
`livemode`	boolean	Live mode indicator
`metadata`	object	Custom metadata
`name`	string \| null	Customer name
`phone`	string \| null	Customer phone
`preferred_locales`	array	Preferred locales
`shipping`	object \| null	Shipping address
`tax_exempt`	string	Tax exempt status
`test_clock`	string \| null	Test clock ID

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Customer ID"
    },
    "object": {
      "type": "string",
      "description": "Object type (customer)"
    },
    "address": {
      "type": [
        "object",
        "null"
      ],
      "description": "Customer address"
    },
    "balance": {
      "type": "integer",
      "description": "Account balance in cents"
    },
    "created": {
      "type": "integer",
      "description": "Creation timestamp"
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "Customer currency"
    },
    "default_source": {
      "type": [
        "string",
        "null"
      ],
      "description": "Default payment source ID"
    },
    "delinquent": {
      "type": "boolean",
      "description": "Account delinquent status"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Customer description"
    },
    "discount": {
      "type": [
        "object",
        "null"
      ],
      "description": "Applied discount"
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "Customer email"
    },
    "invoice_prefix": {
      "type": "string",
      "description": "Invoice prefix"
    },
    "invoice_settings": {
      "type": "object",
      "description": "Invoice settings"
    },
    "livemode": {
      "type": "boolean",
      "description": "Live mode indicator"
    },
    "metadata": {
      "type": "object",
      "description": "Custom metadata"
    },
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Customer name"
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Customer phone"
    },
    "preferred_locales": {
      "type": "array",
      "description": "Preferred locales"
    },
    "shipping": {
      "type": [
        "object",
        "null"
      ],
      "description": "Shipping address"
    },
    "tax_exempt": {
      "type": "string",
      "description": "Tax exempt status"
    },
    "test_clock": {
      "type": [
        "string",
        "null"
      ],
      "description": "Test clock ID"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "stripe_connect": {
      "url": "https://gateway.pipeworx.io/stripe_connect/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

stripe_get_customer