Skip to main content
Tentacle Pay ships a set of agent skills — packaged instructions an AI agent loads on demand to work with Tentacle Pay. Add them to Claude Code (or any agent that loads the skill format) and your agent can set up the tpay wallet, pay for an x402 API, or write x402 payments into your own code — following the same steps these docs describe.
These skills teach your agent how to use Tentacle Pay. To give a running agent a wallet it spends at runtime, see Connecting agents, which exposes tpay over MCP.

​
Install

This adds both skills below. Restart your agent to pick them up.

​
The skills

tpay

The no-code path. Your agent installs tpay, creates and funds a Sui wallet, checks balances, pays for an API with tpay curl, and wires the wallet into Claude over MCP — no integration code.

sui-x402-integration

The SDK path. Your agent adds an x402 paywall to a server (seller) or pays for resources from a client (buyer) with @tentaclepay/sui-x402, pointed at the hosted facilitator.

​
Which one to use

  • Reach for tpay to pay for APIs with no code — the agent runs a shell or speaks MCP, and tpay curl clears any paywall. Mirrors the Wallet docs.
  • Reach for sui-x402-integration when payments live inside your own code — charging for a resource or paying from a custom client. Mirrors the x402 docs.
An agent with both skills picks the right one from your request; you don’t have to name it.

​
What your agent can do

Once the skills are installed, ask in plain language and the agent follows the documented steps:
  • “Install tpay, create a testnet wallet, and pay this endpoint.” → the tpay skill.
  • “Add a $0.01 x402 paywall to my /weather route.” → the sui-x402-integration seller branch.
  • “Wrap my fetch client so it pays for x402 resources automatically.” → the sui-x402-integration buyer branch.
Each skill names the command or code for every step and the condition that means it worked, so the agent can verify its own progress as it goes.

​
Next steps

Wallet overview

What the tpay skill sets up, end to end.

x402 overview

The protocol the sui-x402-integration skill builds on.

Connecting agents

Give a running agent the wallet over MCP.

Skills on GitHub

Source for both skills.