Agent Skills

Give your AI coding agent full knowledge of every Conduit RPC API with a single command. Once installed, your agent knows every endpoint, network, authentication flow, and payment pattern without any manual prompting.

Skills work with Claude Code, Codex, Cursor, VS Code Copilot, and any AI tool that supports the Agent Skills specification.

Install the skill

$
npx skills add conduitxyz/skills --yes

This installs the conduit-rpc-gateway skill, which teaches your agent how to make paid JSON-RPC calls to 59+ networks on Conduit Nodes using MPP payment channels via Tempo.

After installation, your agent will walk you through wallet setup and handle authentication automatically.

What’s included

The skill covers the full Conduit RPC gateway surface:

• EVM JSON-RPC: Standard methods (eth_blockNumber, eth_getBalance, eth_call, eth_getLogs, eth_sendRawTransaction, and more) across all Conduit networks
• 59+ Networks: Zora, Mode, BOB, Derive, Proof of Play Apex, and every network on the Conduit Hub
• Payment flow: Automatic MPP session management — payment channels, signed vouchers, and settlement
• Discovery: Programmatic network discovery via GET /openapi.json and GET /llms.txt
• Error handling: Guidance for 402 Payment Required, 404 Not Found, and JSON-RPC error responses

The skill includes endpoint URLs, authentication patterns, code examples, CLI workflows, and network routing conventions.

How it works

The conduit-rpc-gateway skill uses pay-as-you-go payment channels instead of API keys. Your agent authenticates by opening a USDC payment channel on Tempo, then sends signed off-chain vouchers with each request — no gas fees after the first transaction.

Cost: $0.00005 per JSON-RPC call (~20,000 requests per 1 USDC).

Gateway URL: https://mpp.conduit.xyz

Route format: POST https://mpp.conduit.xyz/:network-id

Payment flow

1. Your agent sends a JSON-RPC request to /:network-id
2. The server returns 402 Payment Required with a WWW-Authenticate: Payment header
3. The client opens a payment channel on-chain (first request only)
4. Subsequent requests include a signed voucher — no gas, no block confirmation, instant
5. Call session.close() to settle on-chain; unused deposit is refunded

Choose a client

Your agent will prompt you to choose a client before making any RPC requests:

1. Tempo Wallet (Recommended) — Managed MPP client with built-in spend controls. No manual key management.
2. mppx — Lightweight MPP client via npx. Manages keys internally.

Set up and fund your wallet

$
curl -fsSL https://tempo.xyz/install | bash
$
tempo wallet login

$
npx mppx account create

$
tempo request -X POST https://mpp.conduit.xyz/zora-mainnet-0 \
>
  -H "Content-Type: application/json" \
>
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

$
npx mppx -X POST https://mpp.conduit.xyz/zora-mainnet-0 \
>
  -H "Content-Type: application/json" \
>
  -d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'

Supported methods

Example networks

Discover all available networks programmatically via /openapi.json or /llms.txt.

Programmatic usage

You can also use the mppx/client SDK to make paid RPC calls from your application:

1
import { tempo } from 'mppx/client'
2
import { createClient, http } from 'viem'
3
import { privateKeyToAccount } from 'viem/accounts'
4
import { tempo as tempoChain } from 'viem/chains'
5
6
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`)
7
const client = createClient({ account, chain: tempoChain, transport: http() })
8
const session = tempo.session({ client, maxDeposit: '1' })
9
10
const response = await session.fetch(
11
  'https://mpp.conduit.xyz/zora-mainnet-0',
12
  {
13
    method: 'POST',
14
    headers: { 'Content-Type': 'application/json' },
15
    body: JSON.stringify({
16
      jsonrpc: '2.0',
17
      method: 'eth_blockNumber',
18
      params: [],
19
      id: 1,
20
    }),
21
  }
22
)
23
24
const data = await response.json()
25
console.log(data)
26
27
// Close the session to settle on-chain; unused deposit is refunded
28
await session.close()

A single payment session can make calls across different networks — the channel is opened once, and subsequent requests to any network use the same signed vouchers.

How skills work

Agent Skills follow an open specification. A skill is a set of Markdown files that contain structured knowledge — API docs, code examples, decision trees, and rules — that an AI agent reads and follows.

When you run npx skills add, the skill files are added to your project. Your AI agent reads these files and uses them as context when writing code or making API requests.

Next steps