Desktop MCP Client Setup

Connect any MCP-compatible desktop client to your Hunch website in seconds. No authentication required by default.

1. Get your connector URL

Open the Hunch dashboard, navigate to Public AI Access, and copy the public connector URL:

https://api.hunchbank.com/public-mcp/{website_id}

Find the website_id in your dashboard under Public AI Access.

2. Configure your client

Paste the connector URL into your MCP client's config file. Replace YOUR_WEBSITE_ID with your actual website ID.

OpenCode

Add to your project's opencode.json:

{
  "mcp": {
    "hunch-public": {
      "type": "remote",
      "url": "https://api.hunchbank.com/public-mcp/YOUR_WEBSITE_ID",
      "enabled": true
    }
  }
}

Restart OpenCode. You should see hunch-public connected in opencode mcp list.

Claude Desktop

Add to claude_desktop_config.json (found in ~/Library/Application Support/Claude/ on macOS or %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "hunch-public": {
      "url": "https://api.hunchbank.com/public-mcp/YOUR_WEBSITE_ID"
    }
  }
}

Restart Claude Desktop. The tools appear under the MCP icon in the chat input.

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hunch-public": {
      "url": "https://api.hunchbank.com/public-mcp/YOUR_WEBSITE_ID"
    }
  }
}

Restart Cursor. The MCP server appears in Settings > MCP Servers.

Windsurf

Add to ~/.windsurf/mcp_config.json:

{
  "mcpServers": {
    "hunch-public": {
      "serverUrl": "https://api.hunchbank.com/public-mcp/YOUR_WEBSITE_ID"
    }
  }
}

Restart Windsurf. The tools are available in Cascade.

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "hunch-public": {
      "type": "http",
      "url": "https://api.hunchbank.com/public-mcp/YOUR_WEBSITE_ID"
    }
  }
}

The MCP server is available in Copilot Chat.

Any MCP client (CLI)

Test the connection with a direct curl call:

curl -sS https://api.hunchbank.com/public-mcp/YOUR_WEBSITE_ID \
  -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3. Verify the connection

After configuring, verify your client can see the tools:

Client	Command / Location
OpenCode	opencode mcp list
Claude Desktop	MCP icon in chat input
Cursor	Settings > MCP Servers
Windsurf	Cascade settings

What the exposed client can do

• Ask questions about the website using site.ask
• Search indexed pages using site.search
• List available workflow skills using site.list_skills
• Execute owner-approved public actions (contact forms, booking, quote requests)
• Claim a live bridge to interact with a visitor's real browser session

Example queries

Once connected, paste these into your MCP client to interact with the website:

What can this website help me do?
Search this website for pricing and summarize the best next step.
List the workflow skills this website exposes and recommend the best one for a new visitor.
Use one approved action from this website to contact support.
Ask about this website's products, policies, or FAQ using site.ask.

Note: Some MCP clients prefer their own built-in web search over MCP tools. If the client fetches the website directly instead of using the connector, prefix your query with using the hunch-public connector to steer it toward the MCP tools.

Troubleshooting

"Failed to get tools" or no tools listed:

• Verify the URL is correct and includes your website ID
• Check that Public AI Access is enabled in the Hunch dashboard (Off → Unlisted or Listed)
• Ensure your client supports the Streamable HTTP MCP transport (most modern clients do)

Connection timeout:

• The endpoint is at api.hunchbank.com — check your network/firewall settings
• Try the curl command above to isolate client vs. network issues

Authentication errors:

• The public connector requires no authentication by default
• If signed visitor tokens are enabled, you need a valid visitor token in the X-Hunch-Visitor-Token header

See Public AI Access Controls for the full configuration reference.