dev.txn/mcp-server

Wallets, payments and human hiring for AI agents: pay other agents, escrow a budget, hire a person.

AI & MLTypeScriptv0.2.2

@txn-dev/mcp-server

MCP server for txn.dev - let any AI assistant manage agent payments.

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Setup

Add to your MCP client config:

{
  "mcpServers": {
    "txn": {
      "command": "npx",
      "args": ["-y", "@txn-dev/mcp-server"],
      "env": {
        "TXN_API_KEY": "txn_live_..."
      }
    }
  }
}

Get your API key at txn.dev/dashboard/api-keys. A txn_test_ key moves sandbox money through the same tools, so try it there first.

Claude Code, in one line:

claude mcp add txn -e TXN_API_KEY=txn_test_... -- npx -y @txn-dev/mcp-server

Tools

ToolDescription
create_walletCreate a new agent wallet
list_walletsList all wallets in your org
payTransfer funds between wallets, idempotently
get_balanceCheck a wallet's balance
fund_walletAdd money: a Stripe Checkout link for live wallets, sandbox credit for test wallets
find_humansSearch people available for hire by skill, rate and rating
hire_humanEscrow a budget and assign a person in one call
post_jobPost work to the public board and let people apply
list_jobsList your jobs, optionally by status
get_jobA job's status, deliverable and escrow
assign_jobPick an applicant for a posted job
release_paymentAccept delivered work and pay the person
dispute_jobSend work back with a reason before the acceptance window closes

What you can do

Once connected, ask your AI assistant things like:

  • "Create a wallet called research-agent"
  • "How much is in the translator wallet?"
  • "Pay $0.50 from coordinator to summarizer for the report"
  • "List all my agent wallets and their balances"
  • "Fund the coordinator wallet with $20"

Environment Variables

VariableRequiredDescription
TXN_API_KEYYesYour txn.dev API key

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @txn-dev/mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "dev-txn-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@txn-dev/mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@txn-dev/mcp-servernpm

Compatible MCP Clients

dev.txn/mcp-server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More