Executable connectorPaymentsJul 22, 20260 calls

Stripe Connector

Executable read-safe Stripe connector for customers, invoices, subscriptions, and payment intents.

Credential setup

bearer

Use a restricted key with read access only to customers, invoices, subscriptions, and payment intents.

Setup docs: https://dashboard.stripe.com/apikeys

After adding this connector, attach the credential on the server page, then run astrail tools list.

Hosted MCP endpoint

/api/mcp/preset-stripe

Private servers require an Astrail API key in the Authorization header.

MCP client snippets

Connect

Claude Desktop config

{
  "mcpServers": {
    "stripe-connector": {
      "url": "/api/mcp/preset-stripe"
    }
  }
}

cURL initialize

curl -sS -X POST "/api/mcp/preset-stripe" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

cURL tools/list

curl -sS -X POST "/api/mcp/preset-stripe" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

cURL tools/call

curl -sS -X POST "/api/mcp/preset-stripe" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"stripe_list_customers","arguments":{"email":"example","limit":10,"starting_after":"example"}}}'

Runtime behavior

Runtime healthhealthy

Endpoint healthnot_checked

Execution modesafe_rest_execution

Deterministic executionSupported

Generated sourceExport only

Endpoint mapAvailable

Endpoint mappedYes

Auth-required endpointsPresent

Browser runtime endpointsNone detected

Last statusnot recorded

Last execution modenot recorded

Last toolnot recorded

Last latencynot recorded

Upstream statusnot recorded

Trace IDnot recorded

Error codenone

Observabilitystructured fallback

Rate limit modestandard

Missing authauth_required / oauth_required

Missing mappingmapping_required

Astrail does not evaluate generated TypeScript inside Next.js. Hosted calls are routed through stored tool metadata and endpoint maps.

Tools

stripe_list_customers

List Stripe customers with optional email filtering.

stripe_get_customer

Retrieve a Stripe customer.

stripe_get_invoice

Retrieve a Stripe invoice.

stripe_list_invoices

List Stripe invoices for a customer or status.

stripe_list_subscriptions

List Stripe subscriptions by customer or status.

stripe_list_payment_intents

List Stripe payment intents.

stripe_get_payment_intent

Retrieve a Stripe payment intent without mutating it.

stripe_list_charges

List Stripe charges with customer and pagination filters.

stripe_list_refunds

List Stripe refunds with charge, payment intent, and pagination filters.

server.ts

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "Stripe Connector", version: "1.0.0" });

// Curated Astrail connector for: stripe_list_customers, stripe_get_customer, stripe_get_invoice, stripe_list_invoices, stripe_list_subscriptions, stripe_list_payment_intents, stripe_get_payment_intent, stripe_list_charges, stripe_list_refunds.
// The hosted endpoint executes its verified deterministic endpoint map. Attach a least-privilege provider credential before calling private tools.

server.tool("connector_status", "Confirm this curated connector template is installed.", z.object({}), async () => ({
  content: [{ type: "text", text: "Connector installed. Attach provider credentials to enable hosted API calls." }],
}));

const transport = new StdioServerTransport();
await server.connect(transport);