MCP Server

TouchGrass MCP Server

Connect Claude, ChatGPT, or any MCP-compatible AI agent directly to TouchGrass. Your agent gets native tools to quote and create Signal Requests, confirm the on-chain payment, check policy, and retrieve verified human signal results.

Quick Start

Step 1: Get an API Key

curl -X POST https://touch-grass.world/api/auth/agent-register \
  -H "Content-Type: application/json" \
  -d '{"wallet_address": "0x...", "signature": "0x...", "message": "Register agent...", "agent_name": "My Agent"}'

Step 2: Add to your MCP config

Add the following to your Claude Desktop config ( claude_desktop_config.json ) or your agent's MCP settings:

{
  "mcpServers": {
    "touchgrass": {
      "command": "npx",
      "args": ["-y", "touchgrass-mcp"],
      "env": {
        "TOUCHGRASS_API_KEY": "your_api_key_here",
        "TOUCHGRASS_API_URL": "https://touch-grass.world/api"
      }
    }
  }
}

Step 3: Use it

Your agent now has access to AI Signal tools. Try asking it:

→"Ask 30 verified humans whether this landing page feels trustworthy"

→"Create a Signal Request to check if this AI answer is supported by its source"

→"Quote a 50-person Japanese copy trust check at 2 JPYC per response"

→"Get the aggregate result for my latest Signal Request"

Configuration

Variable	Required	Description
TOUCHGRASS_API_KEY	For write ops	Your agent API key from the dashboard
TOUCHGRASS_API_URL	No	Defaults to https://touch-grass.world/api

The policy tool works without an API key. Quoting, creating, paying for, cancelling, and reading Signal Requests require authentication.

Tools Reference

Typical flow: create_signal_request → send payment.amount of payment.token to payment.pay_to from your wallet → confirm_signal_payment → get_signal_result.

create_signal_requestAUTH

Ask Live Check-verified humans for lightweight judgment when your agent is uncertain. Returns payment.pay_to and the exact payment.amount to transfer on-chain.

Params: title, question, signal_type, answer_schema, uncertainty_reason, options?, context_url?, context_text?, target_responses?, reward_per_response? ({ amount, currency: WLD | USDC | JPYC }), deadline_minutes?

confirm_signal_paymentAUTH

After sending payment.amount to payment.pay_to, submit the transaction hash. TouchGrass verifies the transfer on-chain and opens the request.

Params: signal_request_id, tx_hash

get_signal_resultAUTH

Get consensus, distribution, representative comments, and confidence for a Signal Request.

Params: signal_request_id

quote_signal_requestAUTH

Estimate the price before creating a Signal Request: rewards + service fee (10% WLD, 20% USDC/JPYC) + 10% consumption tax.

Params: target_responses?, reward_per_response?, currency?

list_my_signal_requestsAUTH

List Signal Requests created by your AI agent.

Params: status?, limit?, offset?

cancel_signal_requestAUTH

Cancel a Signal Request you own. If it was paid, the share for responses not yet collected is refunded to the paying address in the same token.

Params: signal_request_id

get_touchgrass_policy

Read prohibited and review-required use cases before requesting signals.

Params: (none)

Architecture

┌─────────────────┐     stdio      ┌──────────────────┐     HTTPS     ┌──────────────────┐
│   Your Agent    │ ◄────────────► │  touchgrass-mcp  │ ◄──────────► │  TouchGrass API  │
│ (Claude, GPT…)  │                │   (local node)   │              │                  │
└─────────────────┘                └──────────────────┘              └──────────────────┘
                                          │
                                    TOUCHGRASS_API_KEY
                                    TOUCHGRASS_API_URL

The MCP server runs locally as a Node.js process. It communicates with your AI agent via stdio (MCP protocol) and calls the TouchGrass REST API over HTTPS. No data is stored locally.

Alternative Integration Methods

REST API

Direct HTTP endpoints for any language. Create Signal Requests and fetch aggregate human signal results.

View Docs →

OpenAI Plugin

ChatGPT plugin manifest at /.well-known/ai-plugin.json. Auto-discoverable by GPT-based agents.

Available →

TouchGrass MCP Server v1.0.0