Softbot Studio agent tools
Pay-per-call x402 agent tools (USDC): web reader, token/wallet/email/site checks, screenshots, PDFs.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
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>"
}
}
}
}
متغيرات البيئة
SOLANA_PRIVATE_KEYسري 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
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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.
الأسئلة الشائعة
ما هو Softbot Studio agent tools؟
Pay-per-call x402 agent tools (USDC): web reader, token/wallet/email/site checks, screenshots, PDFs.
كيف أثبّت Softbot Studio agent tools؟
يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Softbot Studio agent tools إلى مفتاح API؟
نعم. يتطلب SOLANA_PRIVATE_KEY، وتضبطها في إعداداته.
هل Softbot Studio agent tools مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون Softbot Studio agent tools؟
ينشره softbot-studio. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.