Beta Environment Notice

TDM is currently in Beta. Exercise caution when handling assets. Use at your own risk.

Fast Export

Switch the current page to Markdown for fast agent reading, or download it as a .md file.

TDM Documentation

# TDM Documentation

Summary: Official entry point for the current public TDM stack. This guide covers the SDK, CLI, MCP runtime, AgentPay interpretation, Session Gas Tank flows, seller payouts, checkout, and protocol-first integration paths.

Status: Beta - All Features Active

Topics:
- TDM SDK documentation
- tdm-sdk package usage
- TDM CLI installation and commands
- AgentPay interoperability
- x402 payment flows
- payment options
- MCP session-state checks
- AI agent payment infrastructure

Packages:
- tdm-sdk
- bundled-mcp-runtime
- tdm-agentpay

Commands:
- tdm connect
- tdm fuel
- tdm make payable
- tdm sweep
- tdm sweep status
- tdm cashout
- tdm agent
- tdm stats

Introduction

Documentation for the TDM Beta: tdm-sdk with the built-in tdm CLI, the bundled MCP runtime helper, and tdm-agentpay interoperability.

AI + SEO Overview

Official TDM Beta

This documentation is optimized for both human readers and AI systems looking for guidance on the TDM ecosystem. It focuses on public commands, public request contracts, and practical integration behavior.

Core Packages

tdm-sdk (Beta)
bundled MCP runtime
tdm-agentpay

Beta Features

Paid APIs and routes
Hosted checkout
Framework-mode routes
Smart payable CLI
Session Gas Tank
Seller payouts
MCP session checks
AgentPay interoperability
Public HTTP API
Multi-language integration

CLI Interface

tdm connect
tdm fuel
tdm make payable
tdm sweep
tdm cashout
tdm agent
tdm stats

Integration Paths

Choose Your Integration Path

We now support three clear ways to ship with TDM. Pick the one that matches your runtime, then grow into the others only if you need them.

JS SDK

Framework-Mode

Use tdm-sdk when you want route wrappers, smart tdm make payable, and the fastest path for Next.js, Hono, Express, and other JS runtimes.

Open SDK Path

Protocol-First

Any Language

Call POST /authorize directly from Python, Go, Java, Rust, C, or C++ using the public HTTP contract at https://tdm.todealmarket.com.

Open Multi-Language Path

MCP-Assisted

Agent Runtime

Pair the bundled MCP runtime with AgentPay-aware flows when an AI runtime needs session checks and payment-state guidance around paid tools.

Open Agent Runtime Path

First Hour

First Integration Checklist

If you want the shortest honest path to a working integration, use this sequence before you add sweep automation, payout recovery, or more advanced runtime setup.

01.Install tdm-sdk and decide whether your first path is SDK, protocol-first HTTP, or hosted checkout.
02.Set TDM_GATEWAY_URL or pass an explicit baseUrl.
03.Start with one happy-path request: makePayable(...), tdm-sdk/checkout, or raw POST /authorize.
04.Only add session tanks, payout setup, and recovery flows after that first request is green.

Prepared Surfaces

Start From The Right Public Repo

If you want a direct public entry point instead of reading the whole stack first, use the prepared surface that matches your job. Builders start with the integration kit, agent runtimes go to AgentPay, and note-first creator flows go to Obsidian.

Builders

TDM-Agent-Integration-Kit

Copy-paste recipes, thin client guidance, and reference pieces for coding agents and developers who want to add TDM into real projects fast.

Open Prepared Repos

Agent Runtime

tdm-agentpay

The agent-side reading of authorize, pricing, payment options, session fuel, and recovery behavior.

Open AgentPay

Creator Path

tdm-obsidian

The quickest note-first path for payable reading, paid unlock, and premium knowledge artifacts.

Open Obsidian

TDM SDK

Active Beta

tdm-sdk provides the core building blocks for paid APIs, content, and agent workflows. It includes SDK helpers and the built-in tdm CLI.

MCP Runtime Helper

Ready

The bundled MCP runtime is the optional helper for runtimes that need session checks before they run paid tools or automated flows.

Beta Status

TDM is currently in Beta. The documented public flows are available across the SDK, built-in CLI, MCP runtime, and AgentPay materials, and we are still refining rollout quality and developer ergonomics.

Fully Functional

SDK behavior, checkout, CLI commands, and MCP session-state checks are all active. The public docs focus on what developers can install, call, and use today.

Public Beta Surface

This documentation covers the public TDM SDK, CLI, and API integration paths.

Rapid Iteration

As a Beta, we are shipping updates frequently. Your feedback helps shape the production-ready release of the TDM ecosystem.

How To Use The TDM Beta

The TDM Beta provides a public payment stack for developers. All documented interfaces below are active and ready for integration:

01.Full Integration: Use tdm-sdk for production-shaped payment flows, including framework-mode route wrappers and the built-in CLI.
02.CLI Setup and Operations: Use the tdm CLI for setup, payable registration, top-ups, sweep, stats, and related payment commands.
03.MCP Session Checks: AI agents can query session state through the MCP server runtime before continuing with paid execution.
04.Protocol-First Beyond JS: Teams in Python, Go, Java, Rust, C, and C++ can integrate through the public HTTP contract at https://tdm.todealmarket.com.

Beta Documentation Scope

01.Installation and SDK setup for all environments
02.CLI command reference for fuel, login, and stats
03.AgentPay interoperability and x402 payment flows
04.Local session-state guidance via tdm_get_session_state
05.Fuel, sweep, payout, and related CLI guidance
06.Framework-mode route charging and smart tdm make payable
07.Session Gas Tank and seller payout flows
08.Protocol-first examples for non-JS languages
09.Public product surfaces and integration patterns

Start Installation Open SDK Reference