Skip to content

Add Parallel MCP setup skill with Bifrost support - #55

Merged
sergei1152 merged 5 commits into
parallel-web:mainfrom
jliounis:james-gtm-695-bifrost-search-skill
Sep 17, 2026
Merged

sergei1152 merged 5 commits into
parallel-web:mainfrom
jliounis:james-gtm-695-bifrost-search-skill

Conversation

@jliounis

@jliounis jliounis commented Sep 15, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds parallel-mcp-setup for authenticated Parallel MCP installation, with Parallel Search MCP through Bifrost as the first supported setup path. The shared name allows additional setup paths to be added later. It activates for setup/configuration work; MCP-provided tool descriptions remain the source of search and fetch usage instructions.

The setup uses the authentication-required /mcp-oauth endpoint with a Bearer key or OAuth. It covers secret references, existing-connection handling, downstream tool access, and verification through Bifrost. It offers no anonymous/free setup path.

A supporting reference documents gateway-level Search controls: mode (the Search processing preset), source filters, result/excerpt budgets, location, and fetch policy. Setup preserves Parallel defaults by omitting search overrides. The reference explains opt-in x-parallel-search-config settings, URL parameter precedence, and configuration failure handling. The README lists the skill; existing builders package it for the catalog and release archives.

Validation

  • All 28 existing Python tests pass.
  • Markdown pre-commit checks pass.
  • CDN site and release archive builds pass.
  • JSON setup examples contain authentication only; mode and output limits are left at Parallel defaults. Markdown lint passes after the defaults-only revision.
  • Authentication and configuration guidance checked against current Parallel and Bifrost documentation.

@jliounis
jliounis requested a review from a team September 15, 2026 17:54
@jliounis jliounis changed the title Add direct Search API skill with Bifrost setup Add Parallel Search MCP skill with Bifrost setup Sep 15, 2026
Comment thread skills/parallel-search-mcp/SKILL.md Outdated
@@ -0,0 +1,46 @@
---
name: parallel-search-mcp
description: Use when searching the web or reading URLs with Parallel Search MCP, including through Bifrost, or when asked to set up that MCP connection. Uses the connected web_search and web_fetch tools.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i'm not sure if a skill for using the mcp is needed (its already embedded in the mcp spec with tool descriptions). We should not rely on an llm to read both the skill + mcp tool description to use the mcp. If you think we need better tooling instructions, we can modify the mcp directly perhaps.

Ok if we want to have a plain parallel-mcp-setup skill to help setup the search & task mcp though across whatever agent you happen to be using.

@jliounis jliounis changed the title Add Parallel Search MCP skill with Bifrost setup Add authenticated Bifrost setup skill for Parallel Search MCP Sep 16, 2026
@jliounis
jliounis requested a review from sergei1152 September 16, 2026 18:48
@jliounis jliounis changed the title Add authenticated Bifrost setup skill for Parallel Search MCP Add Parallel MCP setup skill with Bifrost support Sep 17, 2026
@sergei1152
sergei1152 merged commit 26574f4 into parallel-web:main Sep 17, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants