Softbot Studio agent tools
Pay-per-call x402 agent tools (USDC): web reader, token/wallet/email/site checks, screenshots, PDFs.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
softbot-mcpclaude mcp add softbot-studio-agent-tools -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'MAX_SPEND_USDC=<MAX_SPEND_USDC>' -e 'SOFTBOT_DRY_RUN=<SOFTBOT_DRY_RUN>' -- npx -y softbot-mcp@0.2.0
{
"mcpServers": {
"softbot-studio-agent-tools": {
"command": "npx",
"args": [
"-y",
"softbot-mcp@0.2.0"
],
"env": {
"SOLANA_PRIVATE_KEY": "<your solana_private_key>",
"MAX_SPEND_USDC": "<MAX_SPEND_USDC>",
"SOFTBOT_DRY_RUN": "<SOFTBOT_DRY_RUN>"
}
}
}
}
Environment variables
SOLANA_PRIVATE_KEYsecret Solana keypair (base58 or JSON byte array) of a wallet holding USDC; pays each callMAX_SPEND_USDCPer-session spend cap in USDC (default 0.25)SOFTBOT_DRY_RUNSet to 1 to only show prices, never pay
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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":"john@gmial.com"}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:
- Call the endpoint normally. The HTTP 402
PAYMENT-REQUIREDheader carries an x402sign-in-with-x(SIWX, CAIP-122) challenge inextensions["sign-in-with-x"]. - Sign it with your Solana (SIWS, ed25519) or EVM/Base (SIWE, EIP-191) wallet and retry with the
SIGN-IN-WITH-Xheader (createSIWxPayload+encodeSIWxHeaderfrom@x402/extensions/sign-in-with-x). - A free call returns
x-trial: freeandx-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-mcpMCP server does this automatically.
Payment (x402 v2)
- Network: Solana mainnet (
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) - Asset: USDC (
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v), schemeexact - Pay to:
9csHbkGGeQqNxvtZw8hPnC34NCcmZoZXVTEGC1MiDNRE - Facilitator: PayAI (https://facilitator.payai.network)
- Flow: call the endpoint without payment → HTTP 402 with a
PAYMENT-REQUIREDheader → retry with aPAYMENT-SIGNATUREheader (any x402 v2 client does this automatically). Settlement details come back inPAYMENT-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: softbot@mail.grokbot.com
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: USDC0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 - Polygon
eip155:137: USDC0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359(native, not USDC.e) - Arbitrum One
eip155:42161: USDC0xaf88d065e77c8cC2239327C5EDb3A432268e5831(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.
Frequently asked questions
What is Softbot Studio agent tools?
Pay-per-call x402 agent tools (USDC): web reader, token/wallet/email/site checks, screenshots, PDFs.
How do I install Softbot Studio agent tools?
It runs on your machine. In Claude Code: claude mcp add softbot-studio-agent-tools -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'MAX_SPEND_USDC=<MAX_SPEND_USDC>' -e 'SOFTBOT_DRY_RUN=<SOFTBOT_DRY_RUN>' -- npx -y softbot-mcp@0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Softbot Studio agent tools need an API key?
Yes. It expects SOLANA_PRIVATE_KEY, which you set in its configuration.
Is Softbot Studio agent tools open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Softbot Studio agent tools?
It is published by softbot-studio. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.