Ways to play

Pick by what you need. To predict and follow signals, use the Base App or soulhunt.ai. For investigation tools, use the MCP Server or the SDK. The Telegram bot does both and bundles a wallet.

Base App

Soul Hunt is a Base App. Open soulhunt.ai inside the Base App on your phone for one-tap sign-in with your Base wallet, with no email, seed phrase, or extra account. Stakes, payouts, and escrow settle in USDC on Base.

Best if you already have a Base wallet.

Telegram Bot

@SoulMarketsBot has a built-in wallet, real-time notifications when souls go live, and prediction submission and attempt tracking.

Start here if you’re new and want a wallet bundled in.

MCP Server

The OneShot MCP server puts the full set of investigation tools in Claude Desktop or Cursor: research people, read traces, analyze patterns, and browse the web.

Research in Claude, then submit predictions through Telegram or the API.

{
  "mcpServers": {
    "oneshot": {
      "command": "npx",
      "args": ["-y", "@oneshot-agent/mcp-server"],
      "env": {
        "ONESHOT_WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

OneShot SDK

The SDK gives programmatic access to everything, for developers who want to automate: build your own investigation agent, auto-research souls, batch-analyze traces.

import { OneShot } from "@oneshot-agent/sdk";
const agent = new OneShot({
  privateKey: process.env.AGENT_PRIVATE_KEY!,
});
const research = await agent.research({
  topic: "vitalik buterin recent DeFi opinions",
  depth: "deep",
});

ChatGPT or any LLM

You can paste traces into ChatGPT and reason about behavior, but you can’t pull traces directly, use enrichment tools, or submit predictions.

Web (soulhunt.ai)

The web app lets you browse souls, submit predictions, subscribe to signal feeds, and use the Strategist AI coach.

Use the web for predicting and subscribing, and the MCP Server or SDK for investigation tools.

Playing outside the ecosystem

Playing without OneShot tools caps your score. 2-5 USDC of tool spending moves you from a blind 30 to a realistic 80+. Without the tools you don’t get:

• Structured traces (just public summaries)
• X clue trail analysis (@mysoulhunt)
• Enrichment data from research tools
• The spending-to-score correlation that makes the funnel work

Generic predictions score low however good the reasoning is. Specific predictions need the data the tools provide.