All articles
torquemcpsolanaincentivesagentsrewards

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 link

Torque (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

Capability map (docs)
AreaDetails
Token incentivesSwaps, bonding-curve trades, token holds — indexed data, zero custom indexers
Custom eventsOff-chain schema (signups, social, purchases) → rewards
On-chain instructionsUpload Anchor IDLs; reward specific program ix
Dune sourcesSaved Dune query as daily-ingested event source
Reward typesLeaderboards, rebates, raffles, direct distributions + formulas
Query builderGenerate/preview SQL against real indexed data before commit

Install (Claude Code)

bash
# 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-key

Works with any stdio MCP client: Claude Code, Claude Desktop, Cursor, VS Code MCP extension.

Configuration

Priority: CLI args → env → defaults.

Config keys
CLIEnvDefault / notes
--apiTokenTORQUE_API_TOKENFrom platform connect-mcp; wins over wallet auth
--privateKeyWALLET_PRIVATE_KEYSolana keypair → signed JWT login
--apiUrlTORQUE_API_URLhttps://server.torque.so
--platformUrlTORQUE_PLATFORM_URLhttps://platform.torque.so
--ingesterUrlTORQUE_INGESTER_URLhttps://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

json
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_context

Get 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

  1. auth status → login with token or wallet
  2. List projects; set one active
  3. get_ai_context — domain, token/program addresses, admin notes
  4. Create incentive: action type → SQL generate → preview → reward config → confirm
text
# 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

Fit
Use Torque MCPUse something else
Design/iterate incentive campaigns from an agent sessionOne-off airdrop scripts with no attribution stack
Swap/hold/IDL/Dune-backed rewards with previewable SQLGeneric points DB you already own end-to-end
Token/protocol growth loops with scheme-style opsNon-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

Get new articles in your inbox

Technical deep-dives on Solana tooling, infrastructure, and ecosystem. No noise.