About twothumbs
TwoThumbs is a hosted MCP server that checks an AI agent's work against real artifacts and outcomes on public web surfaces. It is intended for teams that need evidence-based verdicts rather than relying on an agent's success report.
Key features
- 01Test visible actions on a public URL
- 02Submit clearly marked synthetic form data
- 03Return verdicts based on downstream outcomes
- 04List configured target surfaces
Use cases
- 01Verify that a web action produced its intended outcome
- 02Check form submissions using synthetic data
- 03Review an agent's reported completion against evidence
MCP support
The hosted Streamable HTTP MCP server at `https://twothumbs.co/mcp` exposes three anonymous tools: `run_verdict`, `list_surfaces`, and `redeem_code`. An API key unlocks additional tools.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://twothumbs.co/mcpclaude mcp add --transport http asselwan-twothumbs https://twothumbs.co/mcp{"mcpServers":{"asselwan-twothumbs":{"type":"http","url":"https://twothumbs.co/mcp"}}}Open in Cursor{"servers":{"asselwan-twothumbs":{"type":"http","url":"https://twothumbs.co/mcp"}}}Open in VS Code{"mcpServers":{"asselwan-twothumbs":{"type":"http","url":"https://twothumbs.co/mcp"}}}{"mcpServers":{"asselwan-twothumbs":{"serverUrl":"https://twothumbs.co/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | No | |
| surface | string | No | |
| register | enum | No | snapshot | executive | debrief |
| max_pages | integer | No |
Details
From the project READMETwoThumbs MCP
Verify what your AI agent actually did — not what it says it did.
TwoThumbs is a hosted, remote MCP server built by NOMOI Labs. It engineers an evidence-backed prompt, challenges weak premises, then checks the real artifact and downstream outcome a public web surface actually produced — instead of trusting a self-reported "success" message. It also carries a much larger internal prompt-engineering and verification-lifecycle tool set (51 tools total), of which the 3 tools below are exposed publicly over the hosted HTTP endpoint.
This repository is a thin discovery wrapper: an MCP client config, a Claude Code plugin manifest, and this README. There is no source code to install or build — the server itself is hosted and run by NOMOI at twothumbs.co.
Connect
The server speaks Streamable HTTP at:
https://twothumbs.co/mcp
No local install, no package, no API key required to use the anonymous tools.
Claude Code
claude mcp add --transport http twothumbs https://twothumbs.co/mcp
Or install this repository as a Claude Code plugin (adds the same server via .mcp.json):
/plugin marketplace add asselwan/twothumbs-mcp
/plugin install twothumbs@twothumbs-mcp
Cursor
Add to your MCP settings (Cursor Settings → MCP):
{
"mcpServers": {
"twothumbs": {
"url": "https://twothumbs.co/mcp"
}
}
}
Generic MCP client
{
"mcpServers": {
"twothumbs": {
"type": "http",
"url": "https://twothumbs.co/mcp"
}
}
}
Works with any client that supports the Streamable HTTP transport — Claude Code, Cursor, Codex, and CI/headless clients included.
Tools
Available anonymously, with a free daily quota:
| Tool | What it does |
|---|---|
run_verdict | Exercises every visible affordance on a public URL — clicking, submitting forms with clearly marked synthetic data — then returns a pass/fail verdict grounded in the real downstream outcome, not a self-reported success message. |
list_surfaces | Lists the target surfaces currently configured for run_verdict. |
redeem_code | Exchanges an access code for an API key. |
An API key additionally unlocks get_last_verdict, get_balance, and set_auto_topup.
Pricing
- Free — 3 surface scans/day, no signup required.
- $9 — 100 credits.
- $29 — 500 credits.
Billing is invoice-based; email through twothumbs.co to request a key, or
use redeem_code with an access code.
Links
- Product: twothumbs.co
- Docs / quickstart: twothumbs.co/docs.html
- Privacy policy: twothumbs.co/privacy
License
The contents of this repository (plugin manifest, client config, documentation) are MIT licensed — see LICENSE. This license covers only this wrapper repository; it does not extend to the TwoThumbs product or hosted service, which remain the property of NOMOI.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.