Enables AI agents to perform web scraping, security checks, and document generation using pay-per-call USDC transactions on Solana.
Also known as softbot-studio/softbot-agents, softbot-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Oct 25, 2026
- License
- —
What is Softbot Studio agent tools MCP?
Softbot Studio agent tools enables AI agents to perform web scraping, security checks, and document generation using pay-per-call USDC transactions on Solana.
Summary generated from the project's README
About Softbot Studio agent tools MCP server
Softbot Studio agent tools provides a suite of specialized functions for AI agents to perform web scraping, security verification, and document generation. Instead of traditional API keys or accounts, this server uses a pay-per-call model where transactions are settled in USDC on the Solana mainnet via x402. Users connect their own wallet by providing a SOLANA_PRIVATE_KEY in their environment variables, and the system manages payments directly from that source.
Developers can integrate these tools into Claude Desktop or Cursor using npx. The server includes specific utilities like read_url for markdown conversion, screenshot_url for visual captures, and page_to_pdf for document creation. Security-focused tools such as check_solana_token, check_wallet, and check_website allow agents to verify digital assets and domain legitimacy. To manage costs, users can set a MAX_SPEND_USDC budget, which defaults to 0.25 USDC per session, and utilize a dry_run mode to preview costs before committing funds.
What you can do with it
- 1Verify cryptocurrency asset safetyCheck if a specific Solana token is safe, requires caution, or should be avoided.
- 2Perform domain and email validationAnalyze a mail domain for MX and SPF records or check if an email address is disposable.
- 3Audit Solana wallet profilesRetrieve a profile for a Solana wallet and check for OFAC matches.
Written from the project's README. Every use case is checked against a quote from it.
How to install Softbot Studio agent tools MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Softbot Studio agent tools MCP in Claude Code
$ claude mcp add --env 'SOLANA_PRIVATE_KEY=<YOUR_SOLANA_PRIVATE_KEY>' softbot-mcp -- npx -y softbot-mcpInstall Softbot Studio agent tools MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"softbot-mcp": {
"command": "npx",
"args": [
"-y",
"softbot-mcp"
],
"env": {
"SOLANA_PRIVATE_KEY": "<YOUR_SOLANA_PRIVATE_KEY>"
}
}
}
}Install Softbot Studio agent tools MCP in VS Code
.vscode/mcp.json
{
"servers": {
"softbot-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"softbot-mcp"
],
"env": {
"SOLANA_PRIVATE_KEY": "<YOUR_SOLANA_PRIVATE_KEY>"
}
}
}
}Install Softbot Studio agent tools MCP in VS Code CLI
$ code --add-mcp '{"name":"softbot-mcp","type":"stdio","command":"npx","args":["-y","softbot-mcp"],"env":{"SOLANA_PRIVATE_KEY":"<YOUR_SOLANA_PRIVATE_KEY>"}}'Install Softbot Studio agent tools MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"softbot-mcp": {
"command": "npx",
"args": [
"-y",
"softbot-mcp"
],
"env": {
"SOLANA_PRIVATE_KEY": "<YOUR_SOLANA_PRIVATE_KEY>"
}
}
}
}Install Softbot Studio agent tools MCP in Codex
$ codex mcp add softbot-mcp --env 'SOLANA_PRIVATE_KEY=<YOUR_SOLANA_PRIVATE_KEY>' -- npx -y softbot-mcpInstall Softbot Studio agent tools MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.softbot-mcp] command = "npx" args = ["-y", "softbot-mcp"] [mcp_servers.softbot-mcp.env] SOLANA_PRIVATE_KEY = "<YOUR_SOLANA_PRIVATE_KEY>"
Install Softbot Studio agent tools MCP in Gemini CLI
$ gemini mcp add -s user -e 'SOLANA_PRIVATE_KEY=<YOUR_SOLANA_PRIVATE_KEY>' softbot-mcp npx -- -y softbot-mcpInstall Softbot Studio agent tools MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"softbot-mcp": {
"command": "npx",
"args": [
"-y",
"softbot-mcp"
],
"env": {
"SOLANA_PRIVATE_KEY": "<YOUR_SOLANA_PRIVATE_KEY>"
}
}
}
}Configuration
SOLANA_PRIVATE_KEYSecretSolana keypair (base58 or JSON byte array) of a wallet holding USDC; pays each call
MAX_SPEND_USDCPer-session spend cap in USDC (default 0.25)
SOFTBOT_DRY_RUNSet to 1 to only show prices, never pay
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablesoftbot-studio/softbot-agents is public and reachablegithub.com/softbot-studio/softbot-agents ↗Pass
- Package names this repository as its sourcesoftbot-mcp names softbot-studio/softbot-agents as sourcenpmjs.com/package/softbot-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-25github.com/softbot-studio/softbot-agents ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from softbot-mcpPass
- No critical advisory in the package or its dependencies230 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubsoftbot-mcp
MCP server for Softbot Studio pay-per-call agent tools. Each call is paid with USDC on Solana mainnet through x402, straight from your own wallet. There are no accounts or API keys, and failed calls are free.
| Tool | What it does | Price (USDC) |
|---|---|---|
read_url |
Page to clean markdown + metadata | 0.003 |
extract_structured |
Tables, JSON-LD, contacts, links, CSS-selector fields | 0.004 |
check_solana_token |
Token safety verdict (safe/caution/avoid) | 0.01 |
check_email |
Email deliverability / disposable / typo check | 0.002 |
check_domain |
Mail domain check (MX, SPF/DMARC/DKIM, age) | 0.002 |
check_wallet |
Solana wallet profile + OFAC match | 0.005 |
check_website |
Website trust / phishing / lookalike check | 0.003 |
screenshot_url |
Page screenshot (returned as an MCP image) | 0.01 |
page_to_pdf |
Page as A4 PDF (embedded resource) | 0.01 |
softbot_status |
Session spend, budget, wallet (free) | 0 |
Every paid tool accepts dry_run: true, which returns the price and endpoint without paying.
Free trial
The first 3 calls of each tool are free per wallet. The server signs the x402 sign-in-with-x challenge with your key automatically (a signature only, no funds move), then pays normally once the trial is used up. Results show free_trial and trial_remaining. Set SOFTBOT_NO_TRIAL=1 to always pay.
Configuration (env vars)
SOLANA_PRIVATE_KEY(required for paid calls) is the keypair of a wallet holding a little USDC (no SOL needed, since the facilitator pays network fees). It takes base58, or the JSON byte array fromsolana-keygen. Use a dedicated low-balance wallet.MAX_SPEND_USDCis the per-session budget. It defaults to0.25, and calls that would exceed it are refused.SOFTBOT_DRY_RUN=1puts every tool in price-only mode.SOLANA_RPC_URLis optional and defaults to the public mainnet RPC.
Claude Desktop
claude_desktop_config.json:
{
"mcpServers": {
"softbot": {
"command": "npx",
"args": ["-y", "softbot-mcp"],
"env": { "SOLANA_PRIVATE_KEY": "<base58 or [..] key>", "MAX_SPEND_USDC": "0.25" }
}
}
}
Cursor
~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"softbot": {
"command": "npx",
"args": ["-y", "softbot-mcp"],
"env": { "SOLANA_PRIVATE_KEY": "<base58 or [..] key>", "MAX_SPEND_USDC": "0.25" }
}
}
}
Safety
- The key is used only locally to sign x402 USDC transfers, and it is never logged or sent anywhere.
- The client refuses to pay if a server asks for more than the advertised price, or for an asset other than USDC.
- The budget resets when the server process restarts.
Develop
npm install && npm run build
node test/smoke.mjs # list tools + dry run each
SOLANA_PRIVATE_KEY=... node test/smoke.mjs paid # one $0.002 check_domain call
MIT licensed.
Softbot Studio agent tools MCP questions
How do I add Softbot Studio agent tools MCP to Claude Code?
Run claude mcp add --env 'SOLANA_PRIVATE_KEY=<YOUR_SOLANA_PRIVATE_KEY>' softbot-mcp -- npx -y softbot-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Softbot Studio agent tools MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How much does it cost to use the tools?
Costs vary by tool, ranging from 0.002 USDC for email checks to 0.01 USDC for screenshots or PDFs. You can use dry_run: true to check the price without paying.
Is there a free trial available?
Yes, the first 3 calls of each tool are free per wallet.
Do I need to hold SOL in my wallet?
No, you only need a wallet holding USDC; the facilitator covers the network fees.