> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tentaclepay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent skills

> Install Tentacle Pay's skills so your AI agent can set up the wallet and write x402 integrations.

Tentacle Pay ships a set of [agent skills](https://github.com/tentaclepay/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.

<Note>
  These skills teach your **agent** how to use Tentacle Pay. To give a **running agent** a wallet it spends at runtime, see [Connecting agents](/wallet/agents), which exposes `tpay` over MCP.
</Note>

## Install

```sh theme={null}
npx skills add tentaclepay/skills
```

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

## The skills

<CardGroup cols={2}>
  <Card title="tpay" icon="wallet">
    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.
  </Card>

  <Card title="sui-x402-integration" icon="code">
    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.
  </Card>
</CardGroup>

## 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](/wallet/overview) 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](/x402/overview) 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

<CardGroup cols={2}>
  <Card title="Wallet overview" icon="wallet" href="/wallet/overview">
    What the `tpay` skill sets up, end to end.
  </Card>

  <Card title="x402 overview" icon="bolt" href="/x402/overview">
    The protocol the `sui-x402-integration` skill builds on.
  </Card>

  <Card title="Connecting agents" icon="robot" href="/wallet/agents">
    Give a running agent the wallet over MCP.
  </Card>

  <Card title="Skills on GitHub" icon="github" href="https://github.com/tentaclepay/skills">
    Source for both skills.
  </Card>
</CardGroup>