mirror of https://github.com/garrytan/gstack.git
103 lines
3.3 KiB
Cheetah
103 lines
3.3 KiB
Cheetah
---
|
|
name: setup-search-mcp
|
|
preamble-tier: 1
|
|
version: 1.0.0
|
|
description: |
|
|
Set up free web search for agents in gstack's Search Before Building workflow.
|
|
Adds Parallel Search MCP with no account or API key by default.
|
|
Use when: "setup search", "install search mcp", "connect Parallel Search MCP",
|
|
"free web search", "agent web search", "make Search Before Building work". (gstack)
|
|
triggers:
|
|
- setup search
|
|
- install search mcp
|
|
- connect parallel search mcp
|
|
- free web search
|
|
- free search mcp
|
|
- agent web search
|
|
- search before building setup
|
|
allowed-tools:
|
|
- Bash
|
|
- AskUserQuestion
|
|
---
|
|
|
|
{{PREAMBLE}}
|
|
|
|
# /setup-search-mcp — Free Web Search for Agents
|
|
|
|
Set up Parallel Search MCP so agents working through Search Before Building get
|
|
free web search. The default setup is free and no-auth: no account, no API key,
|
|
no OAuth.
|
|
|
|
This is not browser automation. Keep `/browse` and `/open-gstack-browser` for
|
|
authenticated pages, screenshots, clicks, visual QA, and stateful browser work.
|
|
Use Search MCP for public web search and clean markdown from public URLs.
|
|
|
|
## User-invocable
|
|
|
|
When the user types `/setup-search-mcp`, run this skill.
|
|
|
|
## Rules
|
|
|
|
- Prefer the current agent host. If this session is Claude Code, configure
|
|
Claude Code. If this session is Codex, configure Codex.
|
|
- Do not install into a different client just because its CLI exists.
|
|
- Do not edit private config files for unknown hosts. Print the manual MCP
|
|
values instead.
|
|
- Do not configure API-key auth or OAuth unless the user explicitly asks for
|
|
higher rate limits. If they do, use AskUserQuestion to ask whether they want
|
|
API-key auth or OAuth before printing or running auth-specific commands.
|
|
|
|
## MCP Values
|
|
|
|
- Server URL: `https://search.parallel.ai/mcp`
|
|
- Transport: Streamable HTTP
|
|
- Authentication: none by default
|
|
- Expected tools after restart: `web_search`, `web_fetch`
|
|
- OAuth URL, only if the user opts in: `https://search.parallel.ai/mcp-oauth`
|
|
|
|
## Claude Code Setup
|
|
|
|
Use this path only when the current agent host is Claude Code:
|
|
|
|
```bash
|
|
claude mcp remove -s user "Parallel-Search-MCP" 2>/dev/null || true
|
|
claude mcp remove "Parallel-Search-MCP" 2>/dev/null || true
|
|
claude mcp add --scope user --transport http "Parallel-Search-MCP" https://search.parallel.ai/mcp
|
|
claude mcp list
|
|
```
|
|
|
|
Then tell the user to restart Claude Code if the new MCP tools are not visible
|
|
in the current session. After restart, Claude-style tool names usually appear as
|
|
`mcp__Parallel-Search-MCP__web_search` and
|
|
`mcp__Parallel-Search-MCP__web_fetch`.
|
|
|
|
## Codex Setup
|
|
|
|
Use this path only when the current agent host is Codex:
|
|
|
|
```bash
|
|
codex mcp remove parallel-search 2>/dev/null || true
|
|
codex mcp add parallel-search --url https://search.parallel.ai/mcp
|
|
codex mcp list --json
|
|
```
|
|
|
|
Then tell the user to restart Codex if the new MCP tools are not visible in the
|
|
current session.
|
|
|
|
## Manual Setup
|
|
|
|
For any other MCP-capable host, do not guess at the config file. Give the user
|
|
the MCP values above and ask them to add the server through that host's normal
|
|
MCP settings. Tell them the host may need a restart before `web_search` and
|
|
`web_fetch` appear.
|
|
|
|
## Report
|
|
|
|
After setup, report:
|
|
|
|
- Which host path you used.
|
|
- That the default setup is free and no-auth.
|
|
- Whether the host command listed the server.
|
|
- Whether the current agent session must be restarted before the new tools are
|
|
available.
|