Skip to main content
The Task MCP Server provides two core capabilities: deep research tasks that generate comprehensive reports, and enrichment tasks that transform existing datasets with web intelligence. Built on the same infrastructure that powers our Task API, it delivers the highest quality at every price point while eliminating complex integration work. The Task MCP comprises three tools:
  • Create Deep Research Task - Initiates a deep research task, returns details to view progress
  • Create Task Group - Initiates a task group to enrich multiple items in parallel.
  • Get Result - Retrieves the results of both deep research as well as task groups in an LLM friendly format.
The Task MCP Server uses an async architecture that lets agents start research tasks and continue executing other work without blocking. This allows spawning any number of tasks in parallel while continuing the conversation. Due to current MCP and LLM client limitations, you need to request the result tool call in an additional turn after results are ready. The Task MCP works best when following this process:
  1. Choose a data source - See Enrichment data sources and destinations.
  2. Initiate your tasks - After you have your initial data, the MCP can initiate deep research or task groups. See Use cases for inspiration.
  3. Analyze the results - The LLM provides a link to view progress as results come in. After completion, prompt the LLM to analyze the results and answer your questions.

​
Enrichment data sources and destinations

The task group tool can be used directly from LLM memory, but is often combined with a data source. The following data sources work well with the Task Group tool:
  • Upload tabular files - Use the Task MCP with Excel sheets or CSVs. Some LLM clients (such as ChatGPT) allow uploading Excel or CSV files. Availability varies by client.
  • Connect with databases - Several MCPs allow your LLM to retrieve data from your database, such as Supabase MCP and Neon MCP.
  • Connect with documents - Documents may contain vital initial information to start a task group. See Notion MCP and Linear MCP.
  • Connect with web search data - Parallel Search MCP or other web tools can provide an initial list of items, which is often a great starting point for a task group.

​
Use cases

The Task MCP serves two main purposes. First, it makes Parallel APIs accessible to anyone requiring reliable research or enrichment without coding skills. Second, it’s a great tool for developers to experiment with different use cases and see output quality before writing code. Below are examples of using the Task MCP (sometimes in combination with other MCPs): Day-to-day data enrichment and research: Assisting development with Parallel APIs: This is just the tip of the iceberg. Share your most compelling use cases with us to grow this list and inspire others!

​
Installation

The Task MCP can be installed in any MCP client. The server URL is: https://task-mcp.parallel.ai/mcp The Task MCP can also be used programmatically by providing your Parallel API key in the Authorization header as a Bearer token.

​
Cursor

Add to ~/.cursor/mcp.json or .cursor/mcp.json (project-specific): 
{
  "mcpServers": {
    "Parallel Task MCP": {
      "url": "https://task-mcp.parallel.ai/mcp"
    }
  }
}
Deep Link: 🔗 Install Task MCP For more details, see the Cursor MCP documentation.

​
VS Code

Add to settings.json in VS Code: 
{
  "mcp": {
    "servers": {
      "Parallel Task MCP": {
        "type": "http",
        "url": "https://task-mcp.parallel.ai/mcp"
      }
    }
  }
}
Deep Link: 🔗 Install Task MCP For more details, see the VS Code MCP documentation.

​
Claude Desktop / Claude.ai

Go to Settings → Connectors → Add Custom Connector, and fill in: 
Name: Parallel Task MCP
URL: https://task-mcp.parallel.ai/mcp
If you are part of an organization, you may not have access to custom connectors. Contact your organization administrator for assistance. If you are not an admin, go to Settings → Developer → Edit Config and add the following JSON after retrieving your API key from Platform: 
"Parallel Task MCP": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://task-mcp.parallel.ai/mcp",
    "--header", "authorization: Bearer YOUR-PARALLEL-API-KEY"
  ]
}
For more details, see the Claude remote MCP documentation.

​
Claude Code

Run this command in your terminal: 
claude mcp add --transport http "Parallel-Task-MCP" https://task-mcp.parallel.ai/mcp
In Claude code, use the command: 
/mcp
Then follow the steps in your browser to login. For more details, see the Claude Code MCP documentation.

​
Windsurf

Add to ~/.codeium/windsurf/mcp_config.json: 
{
  "mcpServers": {
    "Parallel Task MCP": {
      "serverUrl": "https://task-mcp.parallel.ai/mcp"
    }
  }
}
For more details, see the Windsurf MCP documentation.

​
Cline

Go to MCP Servers → Remote Servers → Edit Configuration: 
{
  "mcpServers": {
    "Parallel Task MCP": {
      "url": "https://task-mcp.parallel.ai/mcp",
      "type": "streamableHttp"
    }
  }
}
For more details, see the Cline MCP documentation.

​
Gemini CLI

Add to ~/.gemini/settings.json: 
{
  "mcpServers": {
    "Parallel Task MCP": {
      "httpUrl": "https://task-mcp.parallel.ai/mcp"
    }
  }
}
For more details, see the Gemini CLI MCP documentation.

​
ChatGPT

WARNING: Please note that Developer Mode must be enabled, and this feature may not be available to everyone. Additionally, MCPs in ChatGPT are experimental and may not work reliably. First, go to Settings → Connectors → Advanced Settings, and turn on Developer Mode. Then, in connector settings, click Create and fill in: 
Name: Parallel Task MCP
URL: https://task-mcp.parallel.ai/mcp
Authentication: OAuth
In a new chat, ensure Developer Mode is turned on with the connector(s) selected. For more details, see the ChatGPT Developer Mode documentation.

​
OpenAI Codex CLI

Add to ~/.codex/config.toml: 
[mcp_servers.parallel-task]
url = "https://task-mcp.parallel.ai/mcp"
Alternatively, run this in your terminal. This should start the OAuth flow: 
codex mcp add parallel-task --url https://task-mcp.parallel.ai/mcp
For more details, see the Codex MCP documentation.

​
Amp

Run this command in your terminal: 
amp mcp add "Parallel-Task-MCP" https://task-mcp.parallel.ai/mcp
The OAuth flow will start when you start Amp. For more details, see the Amp MCP documentation.

​
Kiro

Add to .kiro/settings/mcp.json (workspace) or ~/.kiro/settings/mcp.json (global): 
{
  "mcpServers": {
    "Parallel Task MCP": {
      "url": "https://task-mcp.parallel.ai/mcp"
    }
  }
}
For more details, see the Kiro MCP documentation.

​
Google Antigravity

In the Antigravity Agent pane, click the menu (⋮) → MCP Servers → Manage MCP Servers → View raw config, then add: 
{
  "mcpServers": {
    "Parallel-Task-MCP": {
      "serverUrl": "https://task-mcp.parallel.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
For more details, see the Antigravity MCP documentation.

​
Best Practices

​
Choose enabled MCPs carefully

Be careful which tools and features you have enabled in your MCP client. When using Parallel in combination with many other tools, the increased context window may cause degraded output quality. Additionally, the LLM may prefer standard web search or deep research over Parallel if both are enabled. Turn off other web or deep-research tools, or explicitly mention that you want to use Parallel MCPs.

​
Limit data source context size

The Task MCP is a powerful tool for batch deep research, but it is constrained by the context window size and max output tokens of the LLM. Design your prompts and tool calls to avoid overflowing these limitations, or you may experience failures, degraded performance, or lower output quality. For large datasets, use the API or other no-code integrations. The Task MCP is designed for smaller parallel tasks and experimentation.

​
Follow up on tasks

The Task MCP only initiates Deep Research and Task Groups—it does not wait for tasks to complete. Fetch the status or results using a follow-up tool call after research is complete. The asynchronous nature allows initiating several deep researches and task groups without overflowing the context window. To perform multiple tasks or batches in a workflow, reply each time to verify the task is complete and initiate the next step.

​
Use with larger models only

While our Web Search MCP works well with smaller models (such as GPT OSS 20B), the Task MCP requires strong reasoning capability. Use it with larger models only (such as GPT-5 or Claude Sonnet 4.5). Smaller models may result in degraded output quality.

​
Troubleshooting

​
Common Installation Issues

This error occurs when Cline attempts OAuth authentication but the redirect URI isn’t using HTTPS.Solution: Use the API key approach instead of OAuth:
  1. Get your API key from platform.parallel.ai
  2. Configure Cline with the bearer token method:
{
  "mcpServers": {
    "Parallel Task MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://task-mcp.parallel.ai/mcp",
        "--header",
        "authorization: Bearer YOUR-PARALLEL-API-KEY"
      ]
    }
  }
}
Replace YOUR-PARALLEL-API-KEY with your actual API key.
Gemini CLI uses HTTP MCPs and authenticates via OAuth. If OAuth isn’t working, you can provide your API key directly.Solution: Use environment variables or the mcp-remote proxy:
{
  "mcpServers": {
    "Parallel Task MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://task-mcp.parallel.ai/mcp",
        "--header",
        "authorization: Bearer YOUR-PARALLEL-API-KEY"
      ]
    }
  }
}
Add this to ~/.gemini/settings.json and replace YOUR-PARALLEL-API-KEY with your key from platform.parallel.ai.
VS Code requires a specific configuration format. Common mistakes include using the wrong property names.Incorrect (Cursor format):
{
  "mcpServers": {
    "parallel-task": {
      "url": "https://task-mcp.parallel.ai/mcp"
    }
  }
}
Correct (VS Code format):
{
  "mcp": {
    "servers": {
      "Parallel Task MCP": {
        "type": "http",
        "url": "https://task-mcp.parallel.ai/mcp"
      }
    }
  }
}
Note: VS Code uses mcp.servers (not mcpServers) and requires the type: "http" field.
Windsurf uses a different configuration format than Cursor.Correct Windsurf configuration:
{
  "mcpServers": {
    "Parallel Task MCP": {
      "serverUrl": "https://task-mcp.parallel.ai/mcp"
    }
  }
}
Note: Windsurf uses serverUrl instead of url. Add this to your Windsurf MCP configuration file.
If you’re getting connection errors:
  1. Check your network: Ensure you can reach https://task-mcp.parallel.ai
  2. Verify API key: Make sure your key is valid at platform.parallel.ai
  3. Check balance: A 402 error means insufficient credits—add funds to your account
  4. Restart your IDE: Some clients cache MCP connections
If the MCP installs but tools don’t show up:
  1. Restart your IDE completely (not just reload)
  2. Check configuration syntax: Ensure valid JSON with no trailing commas
  3. Verify the server URL: Must be exactly https://task-mcp.parallel.ai/mcp
  4. Check IDE logs: Look for MCP-related errors in your IDE’s output/debug panel