TDM Protocol: Settlement for the Invisible Economy
Infrastructure for humans, businesses, and agents. TDM makes APIs, files, content, and agent workflows payable through a programmable settlement layer with optional Session Gas Tank support.
Infrastructure for humans, businesses, and agents. TDM makes APIs, files, content, and agent workflows payable through a programmable settlement layer with optional Session Gas Tank support.
Install TDM
Put the package and CLI on the machine before anything else.
npm install tdm-sdkThe payment layer for APIs, agent tools, paid execution, and optional content unlock, with a
frictionless settlement experience.
CLI
tdm make payableRegister routes, tools, URLs, and optional paid content through one memorable command.
SDK
makePayable(...)Same idea in code when you want route wrappers instead of a terminal flow.
Start Here
You do not need to learn the whole stack first. Connect once, pick the path that matches your goal, and start accepting or using stablecoins.
Receive Payments
Good when you want the fastest path from a route, tool call, or paid resource to live charging.
Pay Quickly
Good when you want paid calls to keep flowing after one simple setup.
Recover Or Withdraw
Good when you want to clean up dust or send stablecoins back to your wallet.
Ecosystem Reach
External catalogs can surface TDM-backed resources and route buyers into lightweight checkout. When a builder or operator needs vaults, signer access, repeated automation, or deeper runtime control, TDM becomes the native path.
Obsidian
creator notes and paid unlocks
x402 Bazaar
discovery and buy-entry bridge
MPP
service discovery bridge
Choose Your Integration Path
Start with the surface that matches your runtime. The core experience stays the same: paid access, optional Session Gas Tank, and seller payout support across the stack.
JS SDK
Use tdm-sdk for Next.js, Hono, Express, Elysia, and other JS runtimes with payable wrappers, route guards, and smart CLI flows.
Best when you want to wrap a route or tool inside code with makePayable(...).
Open SDK Docs
Protocol-First
Integrate from Python, Go, Java, Rust, C, or C++ through the public TDM contract and ship without waiting for a native SDK.
Best when you already have a live API and just need to make usage payable fast.
Open Multi-Language Docs
MCP-Assisted
Pair the bundled MCP runtime with AgentPay-aware flows when an agent needs session checks, recovery guidance, and safer paid execution.
Best when an agent must decide whether to continue, ask for fuel, or switch into recovery guidance.
Open Agent Docs
Pick Your Use Case
You should be able to tell quickly whether TDM fits your API, open library, artifact sale, or agent runtime before reading the deeper docs.
Open Library
Best for
You publish code on GitHub but want agents to pay for live usage.
Use it for
Hosted API calls, premium query endpoints, and paid tool execution on top of an open codebase.
Flow
Start With
tdm make payable your-api-url
API Or File
Best for
You already have a route, hosted file, dataset, or paid artifact and want a fast go-live path.
Use it for
Per-call APIs, premium downloads, checkout links, and optional paid unlock flows.
Flow
Start With
tdm connect then make payable
Agent Runtime
Best for
You operate agents that need session checks, spend guardrails, and recovery guidance.
Use it for
Session Gas Tank flows, MCP-assisted runtime decisions, sweep recovery, and repeated automation.
Flow
Start With
agentpay plus mcp runtime
TDM For Obsidian
Obsidian is the quick creator path: connect the CLI once, make the current note payable, and keep paid note flows inside the editor instead of building a separate app first.
Good for premium notes, paid knowledge drops, and creator-only unlock flows.
Flat Context For Humans, Bots, And Search
Make APIs, routes, tools, and optional paid content payable through one SDK or a protocol-first HTTP contract.
Let AI agents spend from standard balance or Session Gas Tank, with recovery guidance through MCP-aware runtime tooling.
Route paid usage into seller credits and payout flows without forcing a custom integration stack for every language.
Key Entities
TDM SDK, protocol-first HTTP, Session Gas Tank, seller payouts, MCP runtime guidance, Solana, Base, and USDC.
Primary Use Cases
Paid APIs, monetized files, agent tools, premium content, machine-to-machine transactions, and multi-language service integrations.
TDM is a machine-payments protocol for APIs, agent tools, optional content unlock, and AI runtimes. It gives teams a programmable way to turn usage into paid access and settlement flows.
Developers, platforms, publishers, and agent builders who want monetized APIs, paid tool execution, optional premium content, or machine-to-machine transaction rails.
Teams can integrate through the TDM SDK, a protocol-first HTTP contract, or MCP-assisted runtime guidance depending on the language and workflow they use.
Pricing and fee policy should be treated as deployment-level product configuration. Public docs should focus on the authorize and payout contracts rather than hard-coded fee thresholds.
Architecture for Autonomous Commerce
A unified payment rail for paid access, programmable pricing, and settlement across buyers, sellers, and platform flows.
Selected agents can run on prepaid balance. Fund once, then let high-frequency usage flow through one reusable spending lane.
A focused stdio layer for session-state checks. Use it when agents need to decide between continuing, asking for fuel, or suggesting sweep recovery.
JS teams can use framework-mode wrappers, while Python, Go, Java, Rust, C, and C++ clients can call the same public HTTP contract directly.
Official Settlement, Recovery, And Payout Integration
Start integrating TDM today. Build paid APIs, files, and agents
on one programmable settlement layer.