Skip to main content
Connect Mino to Claude, Cursor, or any MCP-compatible AI assistant. Once connected, your assistant can browse the web and extract data on your behalf.

​
Quick Setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
  "mcpServers": {
    "mino": {
      "url": "https://mino.ai/mcp"
    }
  }
}
Restart Claude Desktop. You’ll be prompted to authenticate via OAuth.

​
Available Tools

​
run_web_automation

Executes web automation and streams progress in real-time. Best for interactive use where you want to see what’s happening. Parameters:
ParameterTypeRequiredDescription
urlstringYesTarget website URL
goalstringYesNatural language description of what to do
browser_profilestringNolite (default) or stealth for anti-detection
proxy_configobjectNoProxy settings with enabled and country_code
Example prompts: 
"Go to https://example.com and extract the product prices"

"Use Mino to scrape the first 5 headlines from https://news.ycombinator.com"

"Navigate to https://weather.com and get today's forecast for NYC"

​
run_web_automation_async

Starts automation asynchronously and returns a run_id immediately. Use this for long-running tasks where you don’t need real-time progress. Parameters: Same as run_web_automation Returns: 
{
  "run_id": "abc123-...",
  "error": null
}
Example prompt: 
"Start an async automation to extract all products from https://store.com, then check the status later"

​
get_run

Retrieves details of a specific automation run by ID. Use this to check status and get results of async runs. Parameters:
ParameterTypeRequiredDescription
idstringYesThe run ID
Returns: 
{
  "run_id": "abc123-...",
  "status": "COMPLETED",
  "goal": "Extract product prices",
  "result": { ... },
  "error": null
}
Example prompt: 
"Check the status of run abc123-def456"

​
list_runs

Lists your automation runs with optional filtering and pagination. Parameters:
ParameterTypeRequiredDescription
statusstringNoFilter by status: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED
cursorstringNoPagination cursor from previous response
limitnumberNoMax results (1-100, default 20)
Example prompts: 
"Show me my recent automation runs"

"List all failed runs"

​
Authentication

Mino MCP uses OAuth 2.1 for secure authentication. The first time you connect, your browser will open to complete the OAuth flow.

​
Before You Start

Make sure you are signed in to both of these in your default browser before triggering the OAuth flow:
  1. claude.ai — your Claude/Anthropic account
  2. mino.ai — your Mino account

​
Authentication Flow

When you first configure the Mino MCP server, Claude Desktop will open your default browser to complete OAuth. Since you’re already signed in to both services, the flow will redirect automatically and complete without manual input.
You need a Mino account with an active subscription or credits. Sign up here.

​
Troubleshooting

  1. Restart your AI client after adding the config
  2. Check that the config JSON is valid
  3. Ensure you’re authenticated (OAuth prompt should appear)
Before starting the OAuth flow, make sure you are already signed in to both services in your default browser:
  1. Open your default browser and sign in to claude.ai
  2. In the same browser, sign in to mino.ai
  3. Then restart Claude Desktop and trigger the OAuth flow again
The OAuth redirect will open in your default browser. If you’re not already signed in there, the flow will fail or get stuck.Still not working?
  • Clear cookies - Clear browser cookies for both claude.ai and mino.ai, then retry
  • Check Mino account - Verify your account is active at mino.ai/api-keys
On Windows, if you see “Server disconnected” errors:
  1. Close Claude Desktop completely - Check Task Manager and end any Claude processes
  2. Use the direct URL method - The recommended setup using "url": "https://mino.ai/mcp" in your config avoids these issues entirely (see Quick Setup above)
  3. Complete OAuth quickly - When the browser opens, complete the sign-in promptly to avoid timeout issues
Complex automations may take 30-60 seconds. For sites with bot protection, the assistant should use browser_profile: "stealth".

Quick Start

Get started with the REST API

API Reference

Full endpoint documentation