parallel-web/task-mcp

**Deep research and data enrichment from your AI assistant.**
Research a question or enrich a small dataset, then retrieve the results without leaving your agent. Parallel hosts the service; you do not need to run this repository to use it.
Task MCP requires a Parallel account and authentication. Unlike the free Search MCP, creating research or enrichment tasks is billable. Review Task API pricing before starting work.
Setup documentation · Get an API key · Task MCP documentation
Manual setup
Choose one connection method for your client. Reuse an existing connection to this endpoint rather than adding it twice.
Claude Code
Run this in the project where you want to use Parallel:
Start a new Claude Code session, run /mcp, and complete the Parallel sign-in in your browser when prompted.
Codex
Make your API key available as PARALLEL_API_KEY in the environment that launches Codex, then run:
Start a new Codex session and run /mcp to check the connection. The configuration references the environment variable, not the key itself. Do not commit API keys to configuration files or paste them into a conversation. For OAuth instead, see the Codex setup instructions.
Cursor, VS Code, and other clients
Use this server URL with HTTP / Streamable HTTP transport:
For Cursor, merge this into your MCP configuration:
Complete the Parallel sign-in when prompted. Clients without compatible OAuth support can use a Parallel API key as a Bearer token in the Authorization header; use the client's secure credential settings rather than hardcoding the key in a shared file.
VS Code uses a top-level servers object, not mcpServers. Follow the client-specific setup instructions for its configuration format and authentication options.
Available tools
| Tool | What it does |
| --- | --- |
| createDeepResearch | Starts a research job for a question that needs a detailed, sourced answer. |
| createTaskGroup | Starts enrichment jobs for a list of inputs using a common output schema. |
| getStatus | Checks whether a run or group is still active. |
| getResultMarkdown | Retrieves research or enrichment output as Markdown. |
Verify the connection by checking that these four tools are available. You do not need to start a paid job just to check installation.
Try it
Research a company:
> Use createDeepResearch to research Parallel Web Systems ( ). Write a company brief covering its products, target customers, and publicly announced funding. Cite your sources and flag anything you cannot verify.
Enrich a list of companies:
> Use createTaskGroup to enrich these three companies: Parallel Web Systems ( ), Google ( ), and Apple ( ). Return one row per company with its official company name, website, headquarters, founding year, and a one-sentence product description. Include source URLs and leave any fields you cannot verify blank.
Research and enrichment run asynchronously:
1. Start the job once and keep its run or group ID.
2. Use getStatus to check progress while continuing other work.