Skip to main content
skill CX Codex

parallel-mcp-setup — Claude Code skill: authenticated Parallel Search MCP via Bifrost

parallel-mcp-setup walks through an authenticated Parallel Search MCP connection behind Bifrost: credentials, client config, tool access, and call verification.

MIT 1,600 installs ★ 97 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add parallel-web/parallel-agent-skills --skill parallel-mcp-setup -a claude-code
Open on GitHub

What parallel-mcp-setup does

This skill covers the full route for connecting Parallel Search MCP through Bifrost. It starts by inspecting the deployment: which Bifrost instance runs, where its config lives (dashboard or config.json), and which downstream agent or virtual key will use the search. Before touching anything, the skill asks you to check existing MCP clients and update the matching Parallel connection instead of adding a duplicate.

The connection points to https://search.parallel.ai/mcp-oauth and must be authenticated. For a shared key, the Bifrost server environment gets PARALLEL_MCP_AUTHORIZATION with the full value Bearer <Parallel API key>, and the client uses Headers auth with Authorization referencing that variable. File-managed deployments get a JSON block to merge into mcp.client_configs, with tools_to_execute limited to web_search and web_fetch.

Verification goes through Bifrost: confirm both tools are discovered, confirm the downstream agent sees them, then run a small search for Python asyncio docs and fetch one returned URL. A 401/403 points to the Parallel key or account access, a handshake 400 points to search overrides. Secrets never go into skill files, prompts, or tool arguments. The marketplace plugin name is bifrost-parallel-mcp-setup.

What it helps with

  • set up an authenticated Parallel Search MCP connection through Bifrost
  • update an existing Parallel client instead of creating duplicates
  • restrict tool access to web_search and web_fetch
  • diagnose 401/403 and 400 failures during setup
  • confirm the downstream agent actually sees both tools

Example prompts for the agent

  • Set up Parallel Search MCP through Bifrost with header auth
  • Verify the Parallel connection by searching asyncio docs and fetching one URL
  • Figure out why Bifrost returns 401 on web_search calls

How to install parallel-mcp-setup

1Skills CLI (Vercel)

npx skills add parallel-web/parallel-agent-skills --skill parallel-mcp-setup -a claude-code

2Manually: put the files in place

~/.claude/skills/parallel-mcp-setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/parallel-mcp-setup/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about parallel-mcp-setup

How do I install parallel-mcp-setup in Claude Code?

Run npx skills add parallel-web/parallel-agent-skills --skill parallel-mcp-setup -a claude-code. The skill lands at ~/.claude/skills/parallel-mcp-setup/SKILL.md.

What does parallel-mcp-setup do?

It describes installing and configuring an authenticated Parallel Search MCP connection through the Bifrost gateway: choosing an auth method, configuring the client, granting tool access, and verifying calls.

Why can't I paste the Parallel API key straight into the client config?

The skill requires secrets to live only in the deployment's secret manager or environment. Skill files, prompts, source control, and tool arguments must stay clear of keys.

Source text

SKILL.md · MIT
---
name: parallel-mcp-setup
description: Use when installing, configuring, or troubleshooting an authenticated Parallel Search MCP connection in Bifrost, including gateway-level search settings and downstream tool access.
---

# Set up Parallel MCP

Configure and verify authenticated Parallel MCP connections. The first supported setup path is Parallel Search MCP through Bifrost; the steps below apply to that path. Tool descriptions supplied by the MCP server govern search and fetch usage; this skill covers installation and gateway configuration.

## 1. Inspect the deployment

Identify the target Bifrost instance, its configuration source (dashboard or `config.json`), and the intended downstream agent or virtual key. Inspect existing MCP clients before changing anything; update the matching Parallel connection instead of adding duplicates. Preserve unrelated clients, access rules, and tool approval settings.

Confirm access to Bifrost management and a Parallel account credential. These are separate from the downstream agent's Bifrost credential. If access or a secret is missing, prepare the configuration and report what is needed without claiming installation succeeded. Keep secrets in the deployment's secret manager or environment; never put them in skill files, source control, prompts, or tool arguments.

## 2. Configure the authenticated connection

Use `https://search.parallel.ai/mcp-oauth`, which requires authentication. Choose Headers auth for a shared Parallel API key, or Bifrost's OAuth flow when that is the deployment's chosen authentication method. Do not change an authentication failure into an unauthenticated connection.

For shared-key configuration, provision `PARALLEL_MCP_AUTHORIZATION` in the **Bifrost server environment** with the complete value `Bearer <Parallel API key>`. The `env.` reference substitutes the whole header value; it does not prepend `Bearer`.

In **MCP Gateway → New MCP Server**, choose HTTP, the URL above, and Headers auth. Set `Authorization` to the environment-variable reference using the UI's env-var picker. Allow `web_search` and `web_fetch` for this connection.

For a file-managed deployment, merge this client entry into the existing `mcp.client_configs` array:

```json
{
  "name": "parallel-search",
  "connection_type": "http",
  "connection_string": "https://search.parallel.ai/mcp-oauth",
  "auth_type": "headers",
  "headers": {
    "Authorization": "env.PARALLEL_MCP_AUTHORIZATION"
  },
  "is_ping_available": false,
  "tools_to_execute": ["web_search", "web_fetch"]
}
```

For OAuth, use the same endpoint with Bifrost's OAuth auth type and complete its admin verification/sign-in flow. Use per-user authentication only when each caller should use their own Parallel account. See [Bifrost authentication](https://docs.getbifrost.ai/mcp/auth/overview) for the chosen flow.

Respect the deployment's reload procedure. Existing connection URL/auth-type changes may require replacing the client because Bifrost treats those fields as immutable; plan that replacement without deleting a working client first. File-managed entries must be updated in the file as well, or a restart can recreate the old configuration.

## 3. Configure gateway controls and access

Keep Parallel’s defaults by omitting search-setting headers and URL parameters. When the user explicitly requests a particular search mode, source policy, or response budget, read [gateway search controls](./references/gateway-controls.md). Apply these as upstream connection settings. Keep the chosen credential and search policy under gateway administration; do not enable caller-supplied overrides of these headers unless explicitly intended.

Confirm Bifrost discovers both tools and grants the intended downstream client or virtual key access to them. Connect the agent to the deployment's Bifrost MCP gateway with its configured downstream authentication. Use the actual discovered tool names, which may be prefixed. Installing this skill does not itself register or expose the MCP tools.

## 4. Verify through Bifrost

1. Confirm the upstream connection is healthy and authenticated, with `web_search` and `web_fetch` discovered.
2. Confirm the intended downstream agent can discover both tools through Bifrost.
3. Run a small search for official Python asyncio documentation, then fetch a returned documentation URL. Use the tools' current schemas and descriptions. Confirm successful results and inspect per-URL errors.
4. Inspect Bifrost's tool-call records to confirm the intended connection was used. Verify account attribution and any configured mode or source policy in available upstream request metadata or account logs; result quality alone does not prove the mode used.
5. Report exactly what was verified and what remains untested. A direct request to Parallel does not prove Bifrost routing, authentication, or downstream permissions.

On a 401/403, check the Parallel credential, account access, and upstream auth configuration. On a handshake 400, check the configured search overrides. For missing tools, inspect connection health and gateway filtering. Keep existing access controls while diagnosing failures.

## Optional: distribute this setup skill through Bifrost

In **Skills Repository → New Skill**, copy this file's name and description into Details, paste only the Markdown body into the SKILL.md editor, and attach `references/gateway-controls.md`. For an existing skill, create a new version. Publish an initial version such as `1.0.0`, then use **Register as Marketplace** and the dashboard's installation commands; the plugin name is `bifrost-parallel-mcp-setup`.

Bifrost serves newly created skills immediately and documents marketplace/download routes as public. Keep deployment credentials and private configuration out of published files. Skill publication is separate from MCP connection setup.

## Sources

- [Parallel Search MCP](https://docs.parallel.ai/integrations/mcp/search-mcp)
- [Bifrost MCP connections](https://docs.getbifrost.ai/mcp/connecting-to-servers)
- [Bifrost header authentication](https://docs.getbifrost.ai/mcp/auth/headers)
- [Bifrost Skills Repository](https://docs.getbifrost.ai/features/skills-repository)

© parallel-web · MIT · parallel-web/parallel-agent-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set14

The whole set →
parallel-findall parallel-findall discovers companies, people, and products matching a natural-language description into a structured list. Useful when you need concrete entities rather than web pages or reports. CX Codex +1 13,000installs parallel-cli-setup parallel-cli-setup — a skill that walks the agent through installing parallel-cli, signing in, checking balance and installing the rest of the Parallel skills. CX Codex +1 6,600installs migrate-to-parallel migrate-to-parallel — a skill for Claude Code, Codex, Cursor and other IDEs that migrates Exa, Tavily, Perplexity or Firecrawl integrations to Parallel products while preserving application behavior. CX Codex +1 3,800installs parallel-memory parallel-memory — a skill that pulls past Parallel Task, Monitor and FindAll runs out of memory when they can help, and removes them on request. CX Codex +1 2,900installs choose-your-parallel-api choose-your-parallel-api guides an agent to the right Parallel API and settings for the job: live web data, a cited answer, reading a URL or PDF, or researching every row of a list. CX Codex +1 1,600installs parallel-search-setup parallel-search-setup walks through checking, using, and fixing the anonymous Parallel Search MCP server that ships with the plugin. Handy when search breaks or keeps returning 429. CX Codex +1 1,500installs parallel-search-evaluation The parallel-search-evaluation Claude Code skill measures search quality, cost, and latency across providers. It activates for Parallel evaluations, provider comparisons, benchmark runs, or troubleshooting evaluation results. CX Codex +1 734installs parallel-api Integrates Parallel API search, page extraction, and web research into apps via Python or TypeScript SDKs. Runs when writing, debugging, or reviewing Parallel API code. CX Codex +1 280installs

Project sponsors

Companies that keep this analytics open