# Cred (remote · eutdgemlrpvnxfkkpvlu.supabase.co)

Issue, deduct, refund and sell credits: checkout, subscriptions, saved cards, escrow and wallets.

- Trust score: 67/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `eutdgemlrpvnxfkkpvlu.supabase.co`: 67/100 (this document), [markdown](https://verifymcp.io/servers/aw3-technology-cred/functions-v1-cred-mcp.md), [page](https://verifymcp.io/servers/aw3-technology-cred/functions-v1-cred-mcp)

## Channel facts

- Endpoint: `https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 49 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 13392 tokens (~273/item across 49 items; 49 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 50/100
  - Stability observed for 15 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 99/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 96% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 8 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "refund_credits" implies "refund" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 49 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 40/100
  - Spec-recency check failed: implements MCP spec 2025-03-26; the latest is 2026-07-28.

## Install

### How do I install the Cred MCP server?

Cred is a hosted endpoint at https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http aw3-technology-cred 'https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "aw3-technology-cred": {
      "url": "https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "aw3-technology-cred": {
      "type": "http",
      "url": "https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.aw3-technology-cred]
url = "https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "aw3-technology-cred": {
      "type": "remote",
      "url": "https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add aw3-technology-cred --url 'https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  aw3-technology-cred:
    url: "https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "aw3-technology-cred": {
      "Transport": "http",
      "Url": "https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add aw3-technology-cred -t streamable-http -u 'https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp'
```

### Other

```json
{
  "mcpServers": {
    "aw3-technology-cred": {
      "type": "http",
      "url": "https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-20 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-18 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-16 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-14 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-12 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-10 (score 62, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-08 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-07 (score 60, 0)

- [functional improvement] Stability: unverified → 0.03

## MCP tools (49)

### `list_credit_types` (~195 tokens)

List the project's active credit types: id, name, symbol, description, exchange_rate (USD per credit), is_redeemable, and on-chain fields (is_on_chain, blockchain, contract_address, chain_id, token_decimals, mint_on_issue, deployment_type). Use the id as credit_type_id in other tools. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `get_balance` (~203 tokens)

Get a user's credit balance(s). Identify the user by email (checked first) or user_id (your external user ID). An unknown user returns an empty balances array, not an error. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Only this credit type
- `email` (string): User email (checked first)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string): External user ID (fallback)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `issue_credits` (~466 tokens)

Issue (add) credits to a user; creates the user if they don't exist (email-first lookup). Pass idempotency_key on anything an agent might retry: a replay returns the original transaction with idempotent_replay: true and issues nothing more (no second webhook or mint). Without a key, every call issues again. For on-chain credit types with mint_on_issue, the response includes on_chain mint status. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `amount` (number, required): Credits to issue (positive)
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string, required): Credit type to issue
- `idempotency_key` (string): Unique key for this issuance (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOT…
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `reason` (string): Reason, shown in the ledger
- `reference_id` (string): Your reference for tracking (not a dedupe key — use idempotency_key)
- `signup_credit_type_id` (string): Credit type the user signed up for (attribution)
- `signup_url` (string): App/page URL a new user signed up from (first-touch attribution)
- `user_email` (string): User email (matched first, stored on a new user)
- `user_id` (string, required): External user ID
- `user_name` (string): Display name for a new user
- `wallet_address` (string): EVM address to mint this issuance to, overriding the one on file (on-chain types only)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `deduct_credits` (~408 tokens)

Deduct (spend) credits from an existing user, identified by user_email (checked first) or user_id. Fails with 400 INSUFFICIENT_CREDITS (nothing deducted) or 404 USER_NOT_FOUND. Pass idempotency_key on anything an agent might retry: a replay returns the original transaction with idempotent_replay: true and charges nothing more. Without a key, every call deducts again. auto_topup_triggered: true means the balance fell below the user's auto top-up threshold and a saved-card purchase started. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `amount` (number, required): Credits to deduct (positive)
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string, required): Credit type to deduct from
- `idempotency_key` (string): Unique key for this deduction (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPO…
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `reason` (string): Reason, shown in the ledger
- `reference_id` (string): Your reference, e.g. a job ID (also lets refund_credits find it)
- `user_email` (string): User email (checked first)
- `user_id` (string): External user ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `get_transactions` (~230 tokens)

List ledger transactions, newest first (types include issue, deduct, refund). Filter by user (email or user_id) and credit_type_id; paginate with limit/offset. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Filter by credit type
- `email` (string): Filter by user email
- `limit` (number): Results per page (max 100, default 50)
- `offset` (number): Pagination offset (default 0)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string): Filter by external user ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `refund_credits` (~540 tokens)

Refund or reverse credits. MOVES MONEY for purchases: with purchase_id or stripe_payment_intent_id it refunds the Stripe charge (prorated when partial; refund_payment: false skips the money) and claws the purchased credits back. With transaction_id (or reference_id = latest matching transaction) it reverses that ledger entry: an issue is clawed back, a deduct is returned to the user. Pass exactly one source. amount refunds part (default: all). idempotency_key is required here: retry with the same key to get the first result (idempotent_replay: true). Errors: 404 PURCHASE_NOT_FOUND / TRANSACTION_NOT_FOUND, 409 ALREADY_REFUNDED, 400 REFUND_EXCEEDS_ORIGINAL, 400 INSUFFICIENT_CREDITS (user already spent them), 400 NOT_REFUNDABLE (redeem/escrow entries), 402 STRIPE_REFUND_FAILED (no credits changed). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `amount` (number): Credits to refund (default: the full original amount)
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `idempotency_key` (string, required): Unique key for this refund (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOTEN…
- `metadata` (object): Extra metadata stored on the refund transaction
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `purchase_id` (string): Cred purchase ID (refunds the payment + credits)
- `reason` (string): Reason, shown in the ledger
- `reference_id` (string): Reverse the latest non-refund transaction with this reference_id
- `refund_payment` (boolean): Purchases only: false reverses credits without refunding money (default true)
- `stripe_payment_intent_id` (string): Stripe pi_… of the purchase (alternative to purchase_id)
- `transaction_id` (string): Ledger transaction ID to reverse
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `create_user` (~319 tokens)

Create an end user, or return/update the existing one (email-first lookup, then external_id, so no duplicates). Returns created: true for a new user. Signup attribution is first-touch and optional: signup_url (else the connection's x-app-origin header) is recorded on a new user, or on an existing user that has none. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `email` (string): User email
- `external_id` (string, required): Your user ID
- `metadata` (object): Arbitrary metadata; stripe_account_id is Cred-only: a value you send is silently dropped
- `name` (string): Display name
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `signup_credit_type_id` (string): Credit type the user signed up for (cross-app attribution)
- `signup_url` (string): App/page URL the user signed up from, e.g. https://app1.example.com/signup
- `wallet_address` (string): 0x EVM address to record as asserted (not verified)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `get_users` (~263 tokens)

Look up one end user by email or external_id (404 USER_NOT_FOUND if absent), or list users newest first with total, filterable by signup_host / signup_credit_type_id. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `email` (string): Look up by email
- `external_id` (string): Look up by external ID
- `limit` (number): Results per page (max 1000, default 100)
- `offset` (number): Pagination offset (default 0)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `signup_credit_type_id` (string): List only users attributed to this credit type
- `signup_host` (string): List only users who signed up from this host, e.g. app1.example.com
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `update_user` (~334 tokens)

Update an existing end user (identify by user_email, checked first, or external_id). Only fields you pass change (none at all is 400 NO_FIELDS_TO_UPDATE); metadata replaces the whole object, except referral_code (kept unless you send it) and stripe_account_id (Cred-only: the stored value stays and a value you send is silently dropped). signup_* fields overwrite attribution (use to correct it). 404 USER_NOT_FOUND. To change a wallet use set_user_wallet. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `email` (string): New email
- `external_id` (string): External ID of the user to update
- `metadata` (object): New metadata (replaces existing)
- `name` (string): New name
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `signup_credit_type_id` (string): Corrected signup credit type
- `signup_host` (string): Corrected signup host
- `signup_url` (string): Corrected signup URL (also re-derives signup_host)
- `user_email` (string): Current email of the user to update
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `delete_user` (~217 tokens)

Delete an end user, identified by user_email (checked first) or external_id. Irreversible: balances, ledger and auto top-up rules go with them. A user with swap history is kept as a financial record — 409 USER_HAS_HISTORY (swap_transactions count). 404 USER_NOT_FOUND. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `external_id` (string): External ID of the user to delete
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_email` (string): Email of the user to delete
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `bulk_create_users` (~208 tokens)

Create or update up to 1000 users in one call (one CRD for the batch). Returns counts of created/updated and per-row errors; a bad row does not fail the batch. A row's own signup_url/signup_host overrides the request-level signup_url. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `signup_url` (string): Default signup URL for rows without their own
- `users` (array, required): User rows
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `get_signup_analytics` (~190 tokens)

Signup attribution breakdown per signup_host (which of your apps users came from): users, purchases and revenue per host over the last `days` (default 30; 0 = all time). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `days` (number): Look-back window in days (default 30, 0 = all time)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `list_pricing_tiers` (~221 tokens)

List active pricing tiers (credit packs), cheapest first; price is a dollar string. credit_type_ids lists the credit types a tier can be bought for; [] means every active credit type. The credit_type_id filter returns every tier purchasable for that type: tiers scoped to it plus tiers with [] (400 if it is not a UUID). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type UUID: tiers scoped to it plus all-type tiers
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `create_pricing_tier` (~336 tokens)

Create a pricing tier. credits must be a positive integer; price (USD) must be 0 or at least 0.50, and at most $1.00 per credit. credit_type_ids lists the credit types a tier can be bought for; [] means every active credit type. Omit credit_type_ids for all types; malformed or foreign ids are rejected. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `billing_type` (string): Which checkouts may sell the tier. A subscription is created only when checkout is sent billing: "recurring"; recurring-only tiers cannot be used for saved-card charges or auto top-up. Default one_ti…
- `credit_type_ids` (array): Credit type UUIDs; omit or [] = all
- `credits` (integer, required): Credits granted per purchase
- `currency` (string): Currency code (default USD)
- `description` (string): Tier description
- `is_popular` (boolean): Highlight as popular
- `name` (string, required): Tier name
- `price` (number, required): Price in dollars
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `update_pricing_tier` (~308 tokens)

Update a pricing tier by id; only fields you pass change (same price rules as create). Pass credit_type_ids to re-scope it ([] = all credit types), is_active: false to stop selling it without deleting. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `billing_type` (string): Which checkouts may sell the tier. A subscription is created only when checkout is sent billing: "recurring"; recurring-only tiers cannot be used for saved-card charges or auto top-up.
- `credit_type_ids` (array): Credit type UUIDs; [] = all
- `credits` (integer)
- `currency` (string)
- `description` (string)
- `id` (string, required): Pricing tier ID
- `is_active` (boolean): Whether the tier can be purchased
- `is_popular` (boolean)
- `name` (string)
- `price` (number): Price in dollars
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `delete_pricing_tier` (~242 tokens)

Permanently delete a pricing tier by id (404 if not in this project). While auto top-up rules buy the tier it refuses with 409 TIER_IN_USE and the rule count; pass force: true (after the user confirms) to delete those rules and the tier together. Deactivating a tier (update_pricing_tier is_active: false) keeps history but makes its auto top-up charges fail. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `force` (boolean): Also delete the auto top-up rules that buy this tier
- `id` (string, required): Pricing tier ID
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `create_checkout_session` (~508 tokens)

Create a Stripe Checkout link for an end user to buy credits; returns checkout_url and session_id. Nothing is charged until the buyer pays on that page; credits are issued when payment completes. Price either a pricing tier (pricing_tier_id, optionally × quantity) or a custom amount (credit_type_id + amount credits, priced at the credit type's exchange_rate). billing: "recurring" creates a subscription (tier required; billing_type recurring or both), credited on every paid invoice; otherwise it is a one-time purchase even on a recurring tier. save_payment_method: true (one-time only) keeps the card for charge_saved_card and auto top-up. success_url and cancel_url must be https on a Cred host or a domain listed under Dashboard → Payments → Allowed redirect domains; on any other domain the link is still created and silently redirects to Cred's default pages. Requires an sk_live_ API key. Not CRD-metered.

Input parameters:

- `amount` (number): Custom-amount checkout: number of credits to sell
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `billing` (string): Default one_time
- `cancel_url` (string): Redirect if the buyer cancels, on an allowed domain (else Cred's default page, no error)
- `credit_type_id` (string): Credit type to grant. Required with amount, and with a tier that allows several types (400 CREDIT_TYPE_REQUIRED otherwise).
- `pricing_tier_id` (string): Tier to sell
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `quantity` (integer): Tier packs (or seats for a subscription); default 1
- `save_payment_method` (boolean): Save the card for off-session charges (one-time checkouts only)
- `signup_url` (string): App/page URL the buyer came from (attribution)
- `success_url` (string): Redirect after payment, on an allowed domain (else Cred's default page, no error)
- `user_email` (string): Buyer email (prefills Checkout, matched first)
- `user_id` (string, required): External user ID of the buyer (created if new)
- `user_name` (string): Buyer display name
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `list_subscriptions` (~219 tokens)

List recurring credit subscriptions (newest 100): status, credits_per_period, quantity, price, interval, current_period_end, cancel_at_period_end. status: "active" matches active, trialing and past_due. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `email` (string): Filter by customer email
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `status` (string): active (live states) or an exact Stripe status, e.g. canceled
- `user_id` (string): Filter by external user ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `cancel_subscription` (~243 tokens)

Cancel a subscription. By default it cancels at period end (credits already issued stay; no further renewals). at_period_end: false cancels immediately with no refund. With user_id/email instead of subscription_id, every live subscription of that customer is canceled. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `at_period_end` (boolean): Default true; false cancels now
- `email` (string): Customer email (alternative to subscription_id)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `subscription_id` (string): Cred subscription ID or Stripe sub_… ID
- `user_id` (string): External user ID (alternative to subscription_id)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `update_subscription_quantity` (~260 tokens)

Change a live subscription's quantity (seats/packs, 1–10000). CHANGES FUTURE BILLING: from the next renewal the customer pays unit price × quantity and receives unit credits × quantity; no proration now. With user_id/email the customer must have exactly one live subscription (else 409 — pass subscription_id). Same quantity is a no-op. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `email` (string): Customer email (alternative to subscription_id)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `quantity` (integer, required): New quantity
- `subscription_id` (string): Cred subscription ID or Stripe sub_… ID
- `user_id` (string): External user ID (alternative to subscription_id)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `create_subscription_portal_link` (~280 tokens)

Create a short-lived Stripe customer portal URL for a subscriber to update their card (flow payment_method_update, default) or see invoices and card (overview). Mint it when the customer asks; don't store it. With user_id/email, uses their most recent subscription. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `email` (string): Customer email (alternative to subscription_id)
- `flow` (string)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `return_url` (string): URL to return to from the portal; must be https on a Cred host or a domain listed under Dashboard → Payments → Allowed redirect domains, else 400 REDIRECT_NOT_ALLOWED
- `subscription_id` (string): Cred subscription ID or Stripe sub_… ID
- `user_id` (string): External user ID (alternative to subscription_id)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `get_saved_payment_method` (~184 tokens)

Get the card saved for a user (brand, last4, expiry), or payment_method: null if none. Cards are saved by a one-time create_checkout_session with save_payment_method: true. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string, required): External user ID of the card holder
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `delete_saved_payment_method` (~182 tokens)

Remove a user's saved card (detached in Stripe). charge_saved_card and auto top-up stop working for them until a new card is saved. Returns deleted: false if there was none. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string, required): External user ID of the card holder
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `charge_saved_card` (~416 tokens)

MOVES MONEY: charge a user's saved card off-session for one pack of a one-time pricing tier and credit it. idempotency_key is required; a retry with the same key never charges twice and returns the first outcome (replayed: true). Outcomes: 200 status succeeded (credits, new_balance); 202 status processing (not yet settled — retry later with the SAME key to check, never a new key); 402 status failed with code/decline_code (requires_action: true means the buyer must pay through checkout instead). Other errors: 404 no_saved_payment_method, 409 saved_payment_method_unusable, 400 tier_not_one_time, 502 charge_not_started (retry with the same key). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type to grant. Required when the tier allows several types (400 CREDIT_TYPE_REQUIRED otherwise)
- `idempotency_key` (string, required): Unique key for this charge (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOTEN…
- `pricing_tier_id` (string, required): One-time (or both) pricing tier to buy
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string, required): External user ID of the card holder
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `get_auto_topup` (~230 tokens)

Get a user's auto top-up rule for credit_type_id (auto_topup, or null), or all their rules (auto_topups) when credit_type_id is omitted, plus their saved card. Rules show threshold, enabled, max_per_day, charges_last_24h, last_status/last_error and disabled_reason (set when cred turned a failing rule off). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type UUID
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string, required): External user ID of the card holder
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `save_auto_topup` (~345 tokens)

Create or replace the auto top-up rule for (user, credit type): whenever a deduct leaves the balance below threshold, cred buys one pack of pricing_tier_id on the user's saved card (at most max_per_day charges per 24h). If enabled and the balance is already below threshold, a charge starts right away. Saving also clears a rule cred disabled after failures. Requires a saved card to charge (a warning is returned if none); the tier must not be recurring-only. 404 USER_NOT_FOUND if the user does not exist. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type to watch. Required when the tier allows several types (400 CREDIT_TYPE_REQUIRED otherwise)
- `enabled` (boolean): Default true
- `max_per_day` (integer): Charge cap per rolling 24h (default 5)
- `pricing_tier_id` (string, required): One-time (or both) pricing tier to buy
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `threshold` (number, required): Top up when the balance falls below this
- `user_id` (string, required): External user ID of the card holder
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `delete_auto_topup` (~206 tokens)

Delete a user's auto top-up rule for credit_type_id, or ALL their rules when credit_type_id is omitted. Returns the number deleted. To pause instead, save_auto_topup with enabled: false. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type UUID (omit to delete every rule for the user)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string, required): External user ID of the card holder
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `create_escrow_hold` (~454 tokens)

Reserve credits: deducts amount from an existing user and parks it in a hold (status held), returning hold_id. Finish with capture_escrow_hold or release_escrow_hold; a hold past expires_at can be released back at any time. Pass idempotency_key on anything an agent might retry: a replay returns the original hold (idempotent_replay: true, with its current status) and holds nothing more; the same key on a different request is 409 IDEMPOTENCY_KEY_REUSED. Without a key every call places another hold. Errors: 400 INSUFFICIENT_CREDITS, 404 USER_NOT_FOUND. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `amount` (number, required): Credits to hold
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string, required): Credit type to hold
- `expires_at` (string): ISO timestamp after which the hold can be released back to the holder
- `idempotency_key` (string): Unique key for this hold (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOTENCY…
- `metadata` (object)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `reason` (string)
- `reference_id` (string): Your reference, e.g. an order ID (filterable in list_escrow_holds)
- `user_email` (string): Holder email (checked first)
- `user_id` (string): External user ID of the holder
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `release_escrow_hold` (~193 tokens)

Release a held hold in full back to its holder (status released). 404 HOLD_NOT_FOUND, 409 HOLD_NOT_ACTIVE if it was already released, captured or expired — so a retry after success is rejected, not repeated. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `hold_id` (string, required): Hold ID
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `reason` (string)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `capture_escrow_hold` (~278 tokens)

Settle a hold (status captured). amount captures part (default: all); the uncaptured remainder returns to the holder. With to_user_id/to_user_email the captured credits go to that user (created if new) — marketplace/P2P settlement; otherwise they stay deducted (settled to the platform). 409 HOLD_NOT_ACTIVE if already settled, 400 CAPTURE_EXCEEDS_HELD. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `amount` (number): Credits to capture (default: the full hold)
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `hold_id` (string, required): Hold ID
- `metadata` (object)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `reason` (string)
- `to_user_email` (string): Email of the recipient
- `to_user_id` (string): External ID of the recipient
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `list_escrow_holds` (~206 tokens)

List escrow holds, newest first, with total. Filter by status, holder or reference_id. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `email` (string): Holder email
- `limit` (number): Max 100, default 50
- `offset` (number)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `reference_id` (string)
- `status` (string)
- `user_id` (string): Holder external ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `list_swap_pairs` (~200 tokens)

List credit swap pairs (exchange_rate, fee_percent, min/max_swap_amount, is_bidirectional). Optionally filter by source or target credit type. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `include_inactive` (boolean): Include inactive pairs
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `source_credit_type_id` (string): Filter by source credit type
- `target_credit_type_id` (string): Filter by target credit type
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `execute_swap` (~401 tokens)

Swap a user's credits along a swap pair: deducts source_amount of the source type and credits the converted amount (after fee) in the target type. Errors: 400 INSUFFICIENT_CREDITS, 404 USER_NOT_FOUND, 400 outside min/max. On a bidirectional pair, direction "reverse" spends the target type for the source type at 1/rate (else 400 SWAP_NOT_BIDIRECTIONAL). Pass an idempotency_key so a retry replays the original swap (idempotent_replay: true); the same key on a different request is 409 IDEMPOTENCY_KEY_REUSED. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `direction` (string): Default forward
- `idempotency_key` (string): Unique key for this swap (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMPOTENCY…
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `source_amount` (number, required): Credits to spend (in the target type when direction is reverse)
- `swap_pair_id` (string, required): Swap pair ID
- `user_email` (string): User email (alternative)
- `user_id` (string): External user ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `get_referral_settings` (~199 tokens)

Get a referral program's settings (is_active, referrer/referee credits, credit type). A project can run one program per credit type: pass credit_type_id for that credit type's program (settings null when it has none); omit it for the project's default program. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type whose program to read
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `save_referral_settings` (~267 tokens)

Create or update a referral program: credits awarded to the referrer and to the referred user. With credit_type_id this writes THAT credit type's program (creating it if needed); without it, the project's default program. Only fields you pass change. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type whose program to write (and award)
- `is_active` (boolean): Enable/disable the program
- `is_default` (boolean): true makes this program the default — the one requests without credit_type_id use (only true is accepted)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `referee_credits` (number): Credits for the referred user
- `referrer_credits` (number): Credits for the referrer
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `generate_referral_code` (~163 tokens)

Get a user's referral code, generating one if they have none (creates the user if needed). Safe to repeat. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string, required): External user ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `apply_referral` (~312 tokens)

Apply a referral code for a referred user, issuing the configured credits to the referee and the referrer. credit_type_id picks the credit type's program (default: the project's default program). defer_referrer_credits pays only the referee now; the referral stays pending until complete_referral pays the referrer. A user can be referred once per program (without credit_type_id: in the default program); a credit_type_id retry with the same code replays (replayed: true): errors 400 ALREADY_REFERRED, SELF_REFERRAL, INVALID_REFERRAL_CODE, or program inactive. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type whose program pays
- `defer_referrer_credits` (boolean): Hold the referrer's credits until complete_referral
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `referral_code` (string, required): The referrer's code
- `user_id` (string, required): External user ID of the referred user
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `complete_referral` (~210 tokens)

Pay the referrer of a referral applied with defer_referrer_credits. user_id is the REFERRED user. Safe to repeat: the payout is keyed per referral; an already completed referral answers already_completed true. 404 NO_REFERRAL. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Credit type whose program the referral belongs to
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_id` (string, required): External user ID of the referred user
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `list_referrals` (~228 tokens)

List the project's referrals, filterable by status, referrer or credit type (program). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Only this credit type's program
- `limit` (number): Results per page (max 100, default 50)
- `offset` (number): Pagination offset
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `referrer_email` (string): Filter by referrer email
- `referrer_user_id` (string): Filter by referrer external ID
- `status` (string): Filter by status
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `redeem_credits` (~581 tokens)

MOVES MONEY: cash out a user's credits as a Stripe transfer to a connected account. Deducts `amount` credits and pays amount × the credit type's exchange_rate (USD per credit; the rate cannot be overridden). The credit type must be redeemable (else 400 NOT_REDEEMABLE). destination must be this user's own account from onboard_payout_account (else 400 INVALID_DESTINATION). Pass idempotency_key: a retry with the same key returns the first result (idempotent_replay: true) and never deducts or pays twice; without one, reference_id is the key, and with neither every call redeems again. 502 PAYOUT_PENDING means Stripe's answer was lost: retry with the SAME key (idempotency_key in the error) to finish it — if nobody retries, the reconciliation sweep settles it after ~15 minutes (paid, or credits returned only if Stripe definitely refused); a claim it cannot settle safely is flagged for manual review. Errors: 400 INSUFFICIENT_CREDITS, 400 PAYOUT_TOO_SMALL, 404 USER_NOT_FOUND, 402 STRIPE_TRANSFER_FAILED (credits restored), 409 IDEMPOTENCY_KEY_REUSED. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `amount` (number, required): Credits to redeem
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string, required): Redeemable credit type
- `currency` (string): Payout currency (default usd)
- `destination` (string, required): Stripe connected account ID (acct_…) that receives the payout
- `idempotency_key` (string): Unique key for this redemption (max 255 chars). Retrying with the same key and same arguments returns the first result instead of repeating it; reusing it for different arguments fails with 409 IDEMP…
- `metadata` (object): String key/values added to the Stripe transfer metadata
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `reason` (string): Reason, shown on the transfer and ledger
- `reference_id` (string): Your reference, stored on the transfer and ledger
- `user_email` (string): User email (alternative)
- `user_id` (string): External user ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `onboard_payout_account` (~281 tokens)

Create (or reuse) a Stripe Express connected account for an end user and return an onboarding URL for them to complete. The resulting stripe_account_id (acct_…) is stored on the user; pass it as destination to redeem_credits. return_url and refresh_url must be https on a Cred host or a domain listed under Dashboard → Payments → Allowed redirect domains, else 400 REDIRECT_NOT_ALLOWED. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `country` (string): ISO country code for the account (default US)
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `refresh_url` (string, required): Where Stripe sends the user if the link expired
- `return_url` (string, required): Where Stripe sends the user after onboarding
- `user_email` (string): User email (alternative)
- `user_id` (string): External user ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `x402_supported` (~72 tokens)

Discover how to pay Cred with x402 (HTTP 402 stablecoin payments): the accepted scheme, network, asset and prices. Pass project_id to also get that project's credit price list. Requires no credentials and costs no CRD.

Input parameters:

- `project_id` (string): Project whose credits you want priced (optional)

### `buy_credits_x402` (~210 tokens)

MOVES MONEY: buy a project's credits by paying in stablecoin over x402. Call once without x402_payment to receive the payment requirements (returned as an error result containing the x402 PaymentRequired object), sign them with your wallet, then call again passing the base64 payment payload as x402_payment. Requires no API key — the payment is the credential — and costs no CRD.

Input parameters:

- `buyer_email` (string): Email to attach to the buyer record
- `buyer_id` (string): Identifier to credit (defaults to your paying wallet address)
- `buyer_name` (string): Display name for the buyer record
- `credit_type_id` (string): Credit type to buy (defaults to the project's x402 credit type)
- `credits` (number, required): How many credits to buy (within the project's min/max)
- `project_id` (string, required): Project selling the credits
- `x402_payment` (string): Base64-encoded x402 PaymentPayload signed by your wallet

### `list_x402_receipts` (~197 tokens)

List this project's x402 stablecoin payments, newest first: kind, status, payer, amount_usd, transaction_hash, credits_granted, error. Authenticated (API key). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `limit` (number): Max 200, default 50
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `status` (string): Filter by status, settled, pending or failed
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `set_user_wallet` (~249 tokens)

Attach an EVM address to an end user so on-chain credits mint to them. No signature required — the address is recorded as asserted by the operator, not proved (changing it clears any earlier verification). Only later deposits match it: a deposit already recorded as unattributed stays uncredited. Pass wallet_address as null to detach; balances are unaffected. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `external_id` (string): External user ID
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_email` (string): User email (checked first)
- `wallet_address` (string|null, required): 0x-prefixed 40-hex-character EVM address, or null to detach
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `get_user_wallet` (~177 tokens)

Read the EVM address on file for an end user, and whether the holder proved it by signature (verified, verified_at). Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `email` (string): User email (checked first)
- `external_id` (string): External user ID
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `request_wallet_challenge` (~228 tokens)

Step 1 of proving an end user controls an address: get a single-use message for them to sign. The message names the operator's project and must be shown to the user unmodified. Expires in ten minutes. Then call verify_wallet_signature with the nonce and the signature their wallet produces. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `address` (string, required): The EVM address the user is claiming
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `external_id` (string): External user ID
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `user_email` (string): User email (checked first)
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `verify_wallet_signature` (~238 tokens)

Step 2: submit the personal_sign signature over the challenge message. On success the address is stored and marked verified. A challenge is single-use and a rejected signature consumes it too — a retry needs a fresh challenge. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `address` (string): Optional guard — rejected if not the address the nonce was issued for
- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `chain_id` (number): Chain the proof was signed on, recorded as provenance
- `nonce` (string, required): The nonce from request_wallet_challenge
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `signature` (string, required): personal_sign output over the challenge message
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

### `list_deposits` (~295 tokens)

List on-chain token deposits observed for the project, newest first (read-only; the chain ingest writes them). status: credited (credits granted), unattributed (sent from an address no user had; held, not credited, and attaching the address with set_user_wallet only matches later deposits), observed (awaiting processing) or rejected. A user filter for an unknown user is 404 USER_NOT_FOUND. Costs 1 CRD (platform credit) per call, charged even when the call is then rejected (a 429 RATE_LIMITED costs nothing). Error results include request_id; quote it to support.

Input parameters:

- `api_key` (string): Cred API key (optional if set via the x-api-key header)
- `credit_type_id` (string): Filter by credit type
- `email` (string): Filter by user email
- `limit` (number): Results per page (max 200, default 50)
- `offset` (number): Pagination offset
- `project_id` (string): Cred project ID (optional; the API key already identifies the project)
- `status` (string)
- `transaction_hash` (string): Find one deposit by transaction hash
- `user_id` (string): Filter by external user ID
- `x402_payment` (string): Base64 x402 PaymentPayload, only when a previous call failed with an x402 PaymentRequired because the account is out of CRD

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/aw3-technology-cred/functions-v1-cred-mcp#diagnostics

## Score history

- 2026-11-21: 67
- 2026-11-20: 67
- 2026-11-19: 66
- 2026-11-18: 66
- 2026-11-17: 65
- 2026-11-16: 65
- 2026-11-15: 64
- 2026-11-14: 64
- 2026-11-13: 63
- 2026-11-12: 63
- 2026-11-11: 62
- 2026-11-10: 62
- 2026-11-09: 61
- 2026-11-08: 61
- 2026-11-07: 60
- 2026-11-06: 60

## Common questions

### What is the Cred MCP server?

Cred is an MCP server listed in the public MCP registry as io.github.aw3-technology/cred. Issue, deduct, refund and sell credits: checkout, subscriptions, saved cards, escrow and wallets. This page covers its hosted endpoint (https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp).

### Is the Cred MCP server safe to use?

Cred scores 67 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Cred MCP server expose?

Cred exposes 49 tools: list_credit_types, get_balance, issue_credits, deduct_credits, get_transactions, and 44 more. Their descriptions and schemas cost roughly 13,392 tokens of context every time the server is loaded.

### Does the Cred MCP server require authentication?

No. We connected to Cred without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Cred MCP server still maintained?

Cred is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Cred MCP server?

VerifyMCP ran 12 checks on Cred, covering TLS certificate, HTTPS, HSTS header, DNSSEC and 8 more. One item could not be completed, a gap on our side rather than a finding about Cred: Authorization. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://eutdgemlrpvnxfkkpvlu.supabase.co/functions/v1/cred-mcp
- Authorisation metadata: https://eutdgemlrpvnxfkkpvlu.supabase.co/.well-known/oauth-protected-resource/functions/v1/cred-mcp
- Website: https://cred.diy/docs/mcp
- Changelog RSS feed: https://verifymcp.io/servers/aw3-technology-cred/functions-v1-cred-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/aw3-technology-cred/functions-v1-cred-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/aw3-technology-cred/functions-v1-cred-mcp.json
- HTML version of this page: https://verifymcp.io/servers/aw3-technology-cred/functions-v1-cred-mcp
