English Français العربية

ThinkerWave

Official registry Search and web

Autonomous research agent for hard problems that labels every claim verified, assumption or guess.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package thinkerwave-mcp
Claude Code 
claude mcp add thinkerwave -e 'THINKERWAVE_API_KEY=<your thinkerwave_api_key>' -- uvx thinkerwave-mcp==0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "thinkerwave": {
            "command": "uvx",
            "args": [
                "thinkerwave-mcp==0.1.2"
            ],
            "env": {
                "THINKERWAVE_API_KEY": "<your thinkerwave_api_key>"
            }
        }
    }
}

Environment variables

  • THINKERWAVE_API_KEY required secret Your ThinkerWave API key (thinkerwave.ai/app → Settings → API keys)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

ThinkerWave

An autonomous research agent for problems without a single right answer — credit risk stress tests, pricing and churn, market entry, due diligence, drug program selection.

You give it the problem and the facts you're sure of. It researches, runs the numbers, checks its own work and tries again, round after round, keeping the best answer. You get the answer, how confident it is, and the evidence behind each claim — verified, assumption or guess — plus any charts and tables it produced.

pip install thinkerwave
export THINKERWAVE_API_KEY=tw_live_…      # create one at thinkerwave.ai/app → Settings → API keys
tw run "Should we raise prices 15%, 8%, or hold? 1,200 customers at \$85/month, 3.1% monthly churn." \
  --given "last 8% increase spiked churn to 4.6% for three months" --rounds 6 --watch

From Claude Code or Cursor: pip install "thinkerwave[mcp]", then claude mcp add thinkerwave -- thinkerwave-mcp — your coding assistant can now hand ThinkerWave a hard question and read back the evidence.

From Python: see examples/.

What's in this repo: the Python SDK, the tw command line, an MCP server, the API reference and the answer/evidence format. ThinkerWave itself runs in ThinkerWave's cloud; this repository is the way in, not the engine.

Free runs are included with every account. Limits: docs/limits.md. Found a problem it got wrong? Open an issue with the run id.

Frequently asked questions

What is ThinkerWave?

Autonomous research agent for hard problems that labels every claim verified, assumption or guess.

How do I install ThinkerWave?

It runs on your machine. In Claude Code: claude mcp add thinkerwave -e 'THINKERWAVE_API_KEY=<your thinkerwave_api_key>' -- uvx thinkerwave-mcp==0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does ThinkerWave need an API key?

Yes. It expects THINKERWAVE_API_KEY, which you set in its configuration.

Is ThinkerWave open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains ThinkerWave?

It is published by thinkerwave-ai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.