list_payment_methods

List configured payment methods for one project. Credentials and provider secrets are never returned.

Purpose

List configured payment methods for one project. Safe to call for agents deciding whether a plan can charge against a given provider.

Provider secrets — API keys, webhook secrets, Stripe Connect account IDs — are always stripped before the response returns.

Required ability

project-payment-method:view-any

Input schema

{
  "type": "object",
  "required": ["project_id"],
  "properties": {
    "project_id": {
      "type": "string",
      "description": "UUID of the project whose payment methods to list."
    },
    "active_only": {
      "type": "boolean",
      "description": "When true, omits deactivated payment methods."
    }
  }
}

Output shape

{
  "data": [
    {
      "id": "8b0c4a15-e792-4360-95d8-1f47c0b3e926",
      "provider": "stripe",
      "mode": "live",
      "active": true,
      "created_at": "2026-03-01T00:00:00Z"
    }
  ],
  "meta": {
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "total": 2
  }
}

Example prompts

"Which payment providers are active on project 7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13?"

"List the live Stripe integration on my Research Premium project."

Failure modes

TOKEN_MISSING_ABILITY — token lacks project-payment-method:view-any.
RESOURCE_NOT_FOUND — project_id names a project the token cannot see: unknown, another team's, or outside the token's scope:project: allow-list. A project with no payment methods returns an empty list, not an error.