Softbot Studio Agent Tools

Softbot Studio agent tools

x402 pay-per-call APIs for AI agents. Store: https://softbot-studio.pages.dev/

Agent skill: softbot-tools

skills/softbot-tools/SKILL.md is an open Agent Skills (SKILL.md) package for Claude Code, Cursor, Codex and similar agents. It tells them when to use these tools, how to set up the softbot-mcp MCP server, and to use the free trial first and confirm with the user before spending USDC. Copy the skills/softbot-tools/ folder into your agent's skills directory.

Softbot Reader

Turns any public web page URL into clean markdown (title, main text, links) for LLM context. Use when an agent needs to read a web page without running a browser.

• Base URL: https://softbot-reader-mainnet.softbot.workers.dev
• POST https://softbot-reader-mainnet.softbot.workers.dev/v1/read — $0.003 — body {"url":"https://example.com"}
• Spec: https://softbot-reader-mainnet.softbot.workers.dev/openapi.json · Discovery: https://softbot-reader-mainnet.softbot.workers.dev/.well-known/x402

Softbot Token Check

Safety verdict (safe / caution / avoid) for a Solana SPL token with reasons: mint & freeze authority, token age, top-10 holder concentration (exchange/pool wallets excluded), metadata and liquidity. Use before trading, accepting or recommending a Solana token.

• Base URL: https://softbot-tokencheck-mainnet.softbot.workers.dev
• POST https://softbot-tokencheck-mainnet.softbot.workers.dev/v1/check — $0.01 — body {"mint":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"}
• Spec: https://softbot-tokencheck-mainnet.softbot.workers.dev/openapi.json · Discovery: https://softbot-tokencheck-mainnet.softbot.workers.dev/.well-known/x402

Softbot Email Check

Email address and domain check: verdict (deliverable_likely / risky / invalid) from syntax, MX/A records, disposable-provider list, role address, free provider, typo suggestion, SPF/DMARC/DKIM and domain age. No SMTP mailbox probing. Use before sending to, signing up, or accepting an email address.

• Base URL: https://softbot-emailcheck-mainnet.softbot.workers.dev
• POST https://softbot-emailcheck-mainnet.softbot.workers.dev/v1/email — $0.002 — body {"email":"[email protected]"}
• POST https://softbot-emailcheck-mainnet.softbot.workers.dev/v1/domain — $0.002 — body {"domain":"example.com"}
• Spec: https://softbot-emailcheck-mainnet.softbot.workers.dev/openapi.json · Discovery: https://softbot-emailcheck-mainnet.softbot.workers.dev/.well-known/x402

Free trial

First 3 calls free per wallet, per tool (each of the 9 endpoints). No payment and no funds needed, just a free signature:

1. Call the endpoint normally. The HTTP 402 PAYMENT-REQUIRED header carries an x402 sign-in-with-x (SIWX, CAIP-122) challenge in extensions["sign-in-with-x"].
2. Sign it with your Solana (SIWS, ed25519) or EVM/Base (SIWE, EIP-191) wallet and retry with the SIGN-IN-WITH-X header (createSIWxPayload + encodeSIWxHeader from @x402/extensions/sign-in-with-x).
3. A free call returns x-trial: free and x-trial-remaining. After 3 successful calls you get a normal 402: pay as usual.

• Failed calls (4xx/5xx) do not use up a trial. A store-wide cap of 200 free calls/day applies; after that, normal pricing.
• The softbot-mcp MCP server does this automatically.

Payment (x402 v2)

• Network: Solana mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)
• Asset: USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v), scheme exact
• Pay to: 9csHbkGGeQqNxvtZw8hPnC34NCcmZoZXVTEGC1MiDNRE
• Facilitator: PayAI (https://facilitator.payai.network)
• Flow: call the endpoint without payment → HTTP 402 with a PAYMENT-REQUIRED header → retry with a PAYMENT-SIGNATURE header (any x402 v2 client does this automatically). Settlement details come back in PAYMENT-RESPONSE.
• Invalid input (4xx) and upstream failures (5xx) are not charged.

Client example

// npm i @x402/fetch @x402/svm @solana/kit
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactSvmScheme } from "@x402/svm/exact/client";
import { createKeyPairSignerFromBytes } from "@solana/kit";
import fs from "fs";
// Your own funded Solana keypair (needs a little USDC). Never commit it.
const signer = await createKeyPairSignerFromBytes(new Uint8Array(JSON.parse(fs.readFileSync(process.env.SOLANA_KEYPAIR))));
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", client: new ExactSvmScheme(signer) }],
});
const r = await pay("https://softbot-reader-mainnet.softbot.workers.dev/v1/read", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({"url":"https://example.com"}) });
console.log(r.status, await r.json());

Contact: [email protected]

EVM USDC: Base, Polygon, Arbitrum (Coinbase CDP)

All APIs also accept native USDC on Base, Polygon and Arbitrum One via the Coinbase CDP x402 facilitator, alongside Solana USDC (PayAI), at the same price. EVM payTo (all three chains): 0xC68F3cCa31D50208ab4C933a38288938e0B21E63.

• Base eip155:8453: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• Polygon eip155:137: USDC 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 (native, not USDC.e)
• Arbitrum One eip155:42161: USDC 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 (native, not USDC.e)

The 402 response lists every payment option; pick any.

Free trial: 3 free calls per wallet per endpoint via Sign-In-With-X. Each service's /llms.txt has a copy-paste example. Listed in the Coinbase x402 Bazaar.