AI Context File

Copy the markdown below into a CLAUDE.md, .cursorrules, or similar AI context file in your project. This gives your AI coding assistant the knowledge it needs to work with the Tesser API without re-reading the full documentation each session.

Usage

1. Copy the content below
2. Save it as CLAUDE.md (for Claude Code), .cursorrules (for Cursor), or any context file your tool supports
3. Place it in your project root

Context File

Code
 
# Tesser Payments API

## Overview

Tesser is a payments platform for stablecoin and fiat transfers. The API handles payment creation, wallet management, counterparty onboarding, compliance screening, and treasury operations.

## API Access

- **Base URL**: `https://sandbox.tesserx.co/v1`
- **Auth**: OAuth 2.0 client credentials → Bearer token
- **Docs**: https://docs.tesser.xyz
- **LLM docs**: https://docs.tesser.xyz/llms-full.txt
- **OpenAPI Schema**: https://docs.tesser.xyz/api/v1/schema.json

### Authentication

```bash
curl --request POST \
  --url https://dev-awqy75wdabpsnsvu.us.auth0.com/oauth/token \
  --header 'content-type: application/json' \
  --data '{
    "client_id": "'$TESSER_API_KEY'",
    "client_secret": "'$TESSER_API_SECRET'",
    "audience": "https://sandbox.tesserx.co",
    "grant_type": "client_credentials"
  }'
```

### Environment Variables

```
TESSER_API_KEY=your-api-key
TESSER_API_SECRET=your-api-secret
```

## MCP Server

All API operations are available as MCP tools at `https://sandbox.tesserx.co/v1/mcp`.

## Key Endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/v1/payments` | Create a payment (payout, deposit) |
| GET | `/v1/payments/{id}` | Get payment by ID |
| PATCH | `/v1/payments/{id}` | Update payment with account info |
| POST | `/v1/payments/{id}/risk-review` | Submit risk review decision |
| GET | `/v1/accounts` | List accounts (wallets, ledgers, bank accounts) |
| POST | `/v1/accounts` | Create an account |
| GET | `/v1/entities/counterparties` | List counterparties |
| POST | `/v1/entities/counterparties` | Create a counterparty |
| GET | `/v1/currencies` | List supported currencies |
| GET | `/v1/networks` | List supported blockchain networks |

## API Conventions

- All request/response fields use **snake_case**
- Amounts are strings (e.g. `"1000.50"`)
- IDs are UUIDs
- Timestamps are ISO 8601 (e.g. `"2025-12-01T09:00:00.000Z"`)
- Webhook events follow the pattern `resource.action` (e.g. `payment.balance_updated`, `step.confirmed`)