// Quick Start

Up and running
in 5 minutes.

Three paths to get started — via MCP (recommended), direct HTTP calls, or the Python/Node SDK.

MCP (recommended) Direct HTTP Python / Node SDK
⭐ RECOMMENDED PATH
// Path 01 — MCP

Via MCP Package

01

Install the MCP package

No installation required — use npx to run directly. Or install globally for repeated use.

# Run directly (no install needed) npx @praveen030686/yantrix-mcp # Or install globally npm install -g @praveen030686/yantrix-mcp
02

Configure your MCP host

Add Yantrix to your MCP config file. Set DEV_MODE=true to test without payments first.

// ~/yantrix_mcp_config.json { "mcpServers": { "yantrix": { "command": "npx", "args": ["@praveen030686/yantrix-mcp"], "env": { "DEV_MODE": "true" } } } }
03

Restart and verify

Restart your MCP host. You should see 30+ Yantrix tools in the tools panel.

# Expected startup output [yantrix-mcp] Starting dynamic MCP server... [yantrix-mcp] Registry: https://registry.yantrix.ai [yantrix-mcp] Registry loaded: 30 tools available [yantrix-mcp] MCP server running on stdio
04

Go live with payments

Get an x402-compatible wallet, fund with USDC on Base, update your config.

# Production config — add payment header "env": { "X_PAYMENT_HEADER": "<your-x402-proof>", "DEV_MODE": "false" } # Get x402 wallet: x402.org · Fund with USDC on Base
// Path 02 — Direct HTTP

Direct HTTP calls

Call any Yantrix API directly via HTTP. Useful for non-MCP agents or backend integrations.

Step 1 — Call without payment (get 402)
curl -X POST https://groundtruth.yantrix.ai/verify \ -H "Content-Type: application/json" \ -d '{"claim": "..."}' # Response: 402 Payment Required { "error": "Payment Required", "amount": "0.002", "token": "USDC", "network": "base-mainnet" }
Step 2 — Retry with payment proof
curl -X POST https://groundtruth.yantrix.ai/verify \ -H "Content-Type: application/json" \ -H "X-PAYMENT: <x402-proof>" \ -d '{"claim": "OpenAI was founded in 2015"}' # Response: 200 OK { "verdict": "TRUE", "confidence": 0.97, "cost": "0.002 USDC" }
// Path 03 — SDK

Python / Node integration

Use standard HTTP clients in your agent code. Works with any Python or Node.js agent framework.

Python
import httpx async def verify_claim(claim: str) -> dict: resp = await httpx.AsyncClient().post( "https://groundtruth.yantrix.ai/verify", json={"claim": claim}, headers={ "X-PAYMENT": payment_proof } ) return resp.json() # Result result = await verify_claim("OpenAI founded 2015") # {"verdict": "TRUE", "confidence": 0.97}
Node.js
const verifyClaim = async (claim) => { const res = await fetch( "https://groundtruth.yantrix.ai/verify", { method: "POST", headers: { "Content-Type": "application/json", "X-PAYMENT": paymentProof }, body: JSON.stringify({ claim }) } ); return res.json(); };
// Next steps

Where to go next.

📋

Browse all APIs

Explore all 17 APIs with filtering, interactive explorer, and Swagger docs.
▶️

Try the live demo

Verify a claim live, watch the x402 animation, explore sample responses.
📦

MCP package details

How the dynamic registry works, all 30+ tools, environment variables.