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»).

NPM package softbot-mcp
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 (Claude Desktop وCursor وVS Code)
{
    "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 call
  • MAX_SPEND_USDC Per-session spend cap in USDC (default 0.25)
  • SOFTBOT_DRY_RUN Set to 1 to only show prices, never pay

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Softbot Studio agent tools
  2. Agent skill: softbot-tools
  3. Softbot Reader
  4. Softbot Token Check
  5. Softbot Email Check
  6. Free trial
  7. Payment (x402 v2)
  8. Client example
  9. EVM USDC: Base, Polygon, Arbitrum (Coinbase CDP)

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.

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.

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.

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: 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: 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.

الأسئلة الشائعة

ما هو 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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.