# Tdm Integration Kit

> Developer integration tools for adding TDM payments to AI agents, apps, and workflows. CLI, MCP server, and copy-paste examples

- **Type:** MCP server
- **Install:** `agentstack add mcp-todealmarket-tdm-integration-kit`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ToDealMarket](https://agentstack.voostack.com/s/todealmarket)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ToDealMarket](https://github.com/ToDealMarket)
- **Source:** https://github.com/ToDealMarket/tdm-integration-kit
- **Website:** https://todealmarket.com/docs

## Install

```sh
agentstack add mcp-todealmarket-tdm-integration-kit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# TDM Integration Kit

**Developer Integration Tools for TDM DaOS**

[](./LICENSE)
[](https://modelcontextprotocol.io/)
[](https://github.com/ToDealMarket/tdm-integration-kit/stargazers)
[](https://www.typescriptlang.org/)

*Reference implementations and copy-paste building blocks for teams integrating with TDM DaOS contracts, payments, and agent runtime surfaces.*

[Documentation](https://todealmarket.com/docs) • [API Reference](https://todealmarket.com/docs/api) • [GitHub](https://github.com/todealmarket) • [X/Twitter](https://x.com/todealmarket)

████████╗ ██████╗  ███╗   ███╗
╚══██╔══╝ ██╔══██╗ ████╗ ████║
   ██║    ██║  ██║ ██╔████╔██║
   ██║    ██║  ██║ ██║╚██╔╝██║
   ██║    ██████╔╝ ██║ ╚═╝ ██║
   ╚═╝    ╚═════╝  ╚═╝     ╚═╝

TDM Integration Kit [V0.1.0]
DaOS Contracts + Client + MCP
Mode: local-first | Docs: todealmarket.com/docs

---

## What is this?

Reference implementations and copy-paste building blocks for integrating with **TDM DaOS** (Decentralized Agent Operating System). This kit provides:

- A thin **JavaScript client** (`@tdm/client`) for CLI + local signer workflows
- A standalone **MCP server** (`@tdm/mcp-server`) with 19 tools for agent runtimes
- **Examples** for Express, Next.js, FastAPI, and Telegram bots

The canonical TDM SDK (`npm install -g tdm-sdk`) is the full operator surface. This kit documents the integration contracts exposed by that SDK and provides reference building blocks for advanced integrations.

---

## Quick Start

```bash
npm install -g tdm-sdk
tdm connect
tdm status
```

Pick a recipe from [`examples`](./examples) or use [`@tdm/client`](./client).

---

## What's Inside

| Component | Package | Purpose |
|-----------|---------|---------|
| [`mcp-server/`](./mcp-server) | `@tdm/mcp-server` | MCP stdio server with 19 tools for agent runtimes |
| [`client/`](./client) | `@tdm/client` | Thin JS wrapper for CLI + local signer HTTP |
| [`examples/`](./examples) | -- | Copy-paste integration recipes |

---

## MCP Server (`@tdm/mcp-server`)

A standalone MCP stdio server exposing TDM session state, capabilities, plugins, memory, and budget context to agent runtimes.

### Available Tools

| Tool | Description |
|------|-------------|
| `tdm_get_session_state` | Read local wallet, balance, setup hints |
| `tdm_capability_list` | List machine-readable capabilities |
| `tdm_agent_status` | Agent readiness, runtime, storage, gateway status |
| `tdm_agent_readiness` | Short agent checklist for handoff |
| `tdm_agent_runtime_report` | Wide bounded runtime surface |
| `tdm_plugin_list` | List registered contour plugins |
| `tdm_plugin_get` | Read single plugin card |
| `tdm_hub_catalog_list` | List Hub catalog entries (filterable, paginated) |
| `tdm_hub_install_plan` | Read Hub install plan (governance-aware) |
| `tdm_contour_run_list` | List recent contour run metadata |
| `tdm_contour_run_latest` | Read latest contour run summary |
| `tdm_checkpoint_list` | List checkpoint metadata |
| `tdm_budget_status` | Read budget/scope status |
| `tdm_memory_health` | Read TDM Agent Memory health |
| `tdm_memory_recall` | Search scoped memory records |
| `tdm_memory_save` | Save scoped memory record (with redaction) |
| `tdm_memory_slots` | List pinned memory slots |
| `tdm_memory_slot_update` | Create/replace pinned memory slot |
| `tdm_memory_forget` | Tombstone memory record with audit |

Setup via CLI:

```bash
tdm mcp          # writes .mcp.json pointing to tdm mcp serve
```

---

## Examples

| Example | Stack | What It Demonstrates |
|---------|-------|---------------------|
| [`express-paywall/`](./examples/express-paywall) | Express.js | `chargeExpressHandler()` with $0.05 paywall |
| [`nextjs-gated/`](./examples/nextjs-gated) | Next.js App Router | `chargeFetchHandler()` in POST route handler |
| [`python-fastapi/`](./examples/python-fastapi) | Python / FastAPI | Local signer HTTP integration from Python |
| [`telegram-bot/`](./examples/telegram-bot) | Python | Subprocess `tdm make payable` for bot workflows |

---

## Choosing the Right Surface

| Surface | When to Use |
|---------|-------------|
| **CLI** | Your stack can shell out; need `connect`, `make payable`, `balance`, `payout`, `unlock` |
| **Local signer HTTP** | Language-agnostic signing from Python, Go, Ruby, Node; no key export |
| **MCP** | Runtime speaks MCP; need session state, plugins, memory, budget context |
| **SDK direct** | `chargeFetchHandler()`, `chargeExpressHandler()`, `createGatewayClients()` for live gateway in JS |

---

## SDK Integration Surface

For JavaScript/TypeScript integrations, the public `tdm-sdk` provides:

| Export | Purpose |
|--------|---------|
| `makePayable()` | Wrap any async function with payment hooks |
| `chargeFetchHandler()` | Protect a fetch handler (Cloudflare Workers, Deno) |
| `chargeExpressHandler()` | Protect an Express route |
| `chargeHonoHandler()` | Protect a Hono route |
| `createFetchHookClient()` | Live gateway authorize + telemetry hooks |
| `createGatewayClients()` | Composed client: authorize + sessionTanks + checkout |
| `createAuthorizeClient()` | Direct payment authorization |
| `createSessionTanksClient()` | Session gas tank management |
| `createCheckoutClient()` | Buyer-facing checkout flows |

---

## Vault and Agent Binding

Agent isolation is vault-first:

- `--vault ` or `TDM_VAULT` selects the active vault
- Each vault has its own credentials under `~/.tdm/vaults//`
- Agents are scoped to one vault at a time
- MCP follows the same resolution order

```bash
tdm vault create photos --use
tdm agent spawn worker-1 --type DISCRETE --limit 5
tdm agent boot worker-1
```

---

## Optional Route Policy

Layered allowlist for stricter outbound control:

```bash
tdm trust verify domain --target api.example.com --resource res_demo123
tdm allowlist add api.example.com --scope vault --vault seller-bot --verified
tdm allowlist check https://api.example.com/private/route --vault seller-bot
```

---

## Security Notes

- **No private keys in this repo** -- this is reference code and guidance
- **OS keyring required** -- CLI stores keys securely
- **Local signer is localhost-only** -- advanced users only
- **Review local automations carefully** -- especially when using advanced signer flows
- **Keep wallet credentials under your control** -- never export private keys

---

## Contributing

1. Fork the repository
2. Create a feature branch
3. Update documentation
4. Add examples
5. Submit a pull request

---

## Documentation

- [TDM Documentation](https://todealmarket.com/docs)
- [SDK Reference](https://todealmarket.com/docs/api/sdk)
- [Integration Guide](https://todealmarket.com/docs/integration-kit)
- [Agent Payment Guide](https://todealmarket.com/docs/agent-pay)

---

## License

MIT License - see [LICENSE](./LICENSE) for details

---

**Built by the TDM team**

[Website](https://todealmarket.com) • [Documentation](https://todealmarket.com/docs) • [GitHub](https://github.com/todealmarket) • [X/Twitter](https://x.com/todealmarket)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ToDealMarket](https://github.com/ToDealMarket)
- **Source:** [ToDealMarket/tdm-integration-kit](https://github.com/ToDealMarket/tdm-integration-kit)
- **License:** MIT
- **Homepage:** https://todealmarket.com/docs

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** yes
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-todealmarket-tdm-integration-kit
- Seller: https://agentstack.voostack.com/s/todealmarket
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.