Torque MCP: incentive programs for Solana via agents
Technical guide to Torque MCP (@torque-labs/mcp) — create and manage Solana reward programs from Claude/Cursor/VS Code. Auth token or wallet JWT, projects, incentives (swaps, holds, IDL instructions, Dune, custom events), query builder.
devrels.xyz/a/240short linkTorque (torque.so) is on-chain incentive infrastructure for Solana token and protocol teams — campaigns that reward swaps, holds, program interactions, and off-chain events. The Torque MCP Server exposes that surface to AI assistants over the Model Context Protocol.
Package: @torque-labs/mcp. Platform: platform.torque.so. Docs hub: platform.torque.so/docs.
What the MCP can do
| Area | Details |
|---|---|
| Token incentives | Swaps, bonding-curve trades, token holds — indexed data, zero custom indexers |
| Custom events | Off-chain schema (signups, social, purchases) → rewards |
| On-chain instructions | Upload Anchor IDLs; reward specific program ix |
| Dune sources | Saved Dune query as daily-ingested event source |
| Reward types | Leaderboards, rebates, raffles, direct distributions + formulas |
| Query builder | Generate/preview SQL against real indexed data before commit |
Install (Claude Code)
# Node.js >= 20 required
# Account: https://platform.torque.so/
# Basic
claude mcp add torque -- npx @torque-labs/mcp@latest
# With API token (recommended)
claude mcp add torque -e TORQUE_API_TOKEN=your-token -- npx @torque-labs/mcp@latest
# Or wallet private key (base58)
claude mcp add torque -- npx @torque-labs/mcp@latest --privateKey your-base58-keyWorks with any stdio MCP client: Claude Code, Claude Desktop, Cursor, VS Code MCP extension.
Configuration
Priority: CLI args → env → defaults.
| CLI | Env | Default / notes |
|---|---|---|
--apiToken | TORQUE_API_TOKEN | From platform connect-mcp; wins over wallet auth |
--privateKey | WALLET_PRIVATE_KEY | Solana keypair → signed JWT login |
--apiUrl | TORQUE_API_URL | https://server.torque.so |
--platformUrl | TORQUE_PLATFORM_URL | https://platform.torque.so |
--ingesterUrl | TORQUE_INGESTER_URL | https://ingest.torque.so |
Tokens: platform MCP tokens ~60 days; wallet JWTs ~ 30 days. Persisted in package local cache across restarts. Config token overwrites stale disk token on startup.
Auth tool
auth({ "action": "status" })
auth({ "action": "login", "authToken": "..." })
auth({ "action": "login" }) // wallet path when private key configured
auth({ "action": "logout" }) // clears token; not project/chat — use reset_contextGet a token at platform.torque.so/connect-mcp. If both token and key are set, token wins — mismatched accounts can make CLI actions invisible in the dashboard.
reset_context clears active project, AI context cache, and ask_torque chat — keeps auth. Prefer set_active_project when switching projects.
Typical first session
authstatus → login with token or wallet- List projects; set one active
get_ai_context— domain, token/program addresses, admin notes- Create incentive: action type → SQL generate → preview → reward config → confirm
# Natural-language prompts that map to tools
"Authenticate with Torque using this token: <token>"
"Show my Torque projects and set one active"
"Create a new incentive for my project"When to use
| Use Torque MCP | Use something else |
|---|---|
| Design/iterate incentive campaigns from an agent session | One-off airdrop scripts with no attribution stack |
| Swap/hold/IDL/Dune-backed rewards with previewable SQL | Generic points DB you already own end-to-end |
| Token/protocol growth loops with scheme-style ops | Non-Solana campaign tooling only |
Links
Summary
Torque MCP is the agent interface to Solana incentive campaigns: install @torque-labs/mcp, auth with a platform token (or wallet), select a project, load context, then build incentives with query preview before going live. Start at the quickstart.
Keep reading
Agents still hit APIs that want a human account and credit card. pay.sh turns 402 Payment Required into a one-line wallet-approved call on Solana stablecoins.
Point Codex, Claude Code, Cursor, or VS Code at https://mcp.solana.com/mcp and prefer live Solana docs over model memory — plus a security autofixer loop for program Rust.
Paste https://api.paybox.sh/mcp into your agent. The user grants a wallet or card once. The agent gets signatures and payment artifacts — not seeds, not PANs.
Get new articles in your inbox
Technical deep-dives on Solana tooling, infrastructure, and ecosystem. No noise.
