Install Hunch in your AI agent
Hunch is a remote MCP server at https://hunchsheet.app/mcp. Add that URL to your agent and sign in when it asks; the agent then has tools that judge, tag and score batches of text. To try it first with no account, use https://hunchsheet.app/mcp/try instead: ten texts a day are free.
One line for every agent
add-mcp is a small open-source tool that writes the server into the config of every agent it finds on your machine (Claude Code, Cursor, VS Code, Codex, Gemini CLI and others), in each one's own format.
npx add-mcp https://hunchsheet.app/mcp -yOpen your agent, and it shows Hunch as needing sign-in. Sign in with a key you have, or press Start with 100 free rows on the sign-in page: no email, no card.
To try Hunch without any sign-in, use the keyless URL instead. Pick one of the two, not both.
npx add-mcp https://hunchsheet.app/mcp/try -yOne command per client
| Client | Command or steps |
|---|---|
| Claude Code | claude mcp add --transport http hunch https://hunchsheet.app/mcp, then run /mcp, choose hunch and Authenticate. |
Claude Code plugin (adds /hunch-check, /hunch-tag, /hunch-score for CSV files) | claude plugin marketplace add Eddy1919/hunch-mcp, then claude plugin install hunch@hunch-mcp. |
| Claude on the web and Claude Desktop | Customize, Connectors (Settings, Connectors in the desktop app), Add custom connector, URL https://hunchsheet.app/mcp. |
| ChatGPT | Settings, Apps & Connectors, Advanced settings, turn on developer mode, add a connector with URL https://hunchsheet.app/mcp. Developer mode needs a paid plan; details on the connectors page. |
| Codex CLI | codex mcp add hunch --url https://hunchsheet.app/mcp, then codex mcp login hunch. |
| Gemini CLI | gemini mcp add --transport http hunch https://hunchsheet.app/mcp. Or the extension: gemini extensions install https://github.com/Eddy1919/hunch-mcp. |
| Cursor | Install link, or add {"url":"https://hunchsheet.app/mcp"} under mcpServers.hunch in ~/.cursor/mcp.json. |
| VS Code | code --add-mcp '{"name":"hunch","type":"http","url":"https://hunchsheet.app/mcp"}' |
| Any other MCP client | Add a streamable HTTP server with URL https://hunchsheet.app/mcp. If the client only speaks stdio: npx -y mcp-remote https://hunchsheet.app/mcp. |
For the keyless version, replace /mcp with /mcp/try in any of these and skip the sign-in step.
No account: the keyless connection
https://hunchsheet.app/mcp/try needs no sign-in and no key. The judging tools answer from a free sample of ten texts a day per network address. When you want more, the tool hunch_get_key returns a key with 100 free rows in its result, with no email, and you pass it as the api_key argument. Nothing has to be reconfigured.
When the free rows run out, hunch_buy_credits returns a checkout link for the person to open. How an agent buys explains the flow.
Check that it works
List the tools with one request. No key is needed on the keyless URL:
curl -s https://hunchsheet.app/mcp/try -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Or ask your agent: Use Hunch to rate how urgent each of these five emails is, from 1 to 4. It should call hunch_score.
With a key instead of the sign-in page
Scripts, CI and clients without a browser can send a key in a header. Get a free one with POST https://hunchsheet.app/trial and body {"source":"agent"}, or use one from a purchase.
claude mcp add --transport http hunch https://hunchsheet.app/mcp --header "Authorization: Bearer hunch_your_key_here"Not an MCP client?
The same engine has a plain HTTP API, described in openapi.json. It also fills a whole column in Google Sheets, Excel and the CSV runner, with the same key.
Questions
What does the sign-in page ask for?
Which should I add, /mcp or /mcp/try?
/mcp for everyday use: it signs in once and uses your credits. Add /mcp/try to evaluate Hunch with no account: it has a small daily sample and the tools to get a free key or a checkout link.Does it cost anything to install?
Try it in one line
Connect https://hunchsheet.app/mcp/try from any MCP client with no account: ten texts a day are free, and the tools can get you a key with 100 free rows. Install lines for Claude Code, Cursor, Codex, Gemini CLI, VS Code and more. Prices are in pricing.json.