Web Research

name: "Brave Search (containerized)"
description: "Web search using Brave's search API. Runs in a container with outbound network access for search requests."

brave-search:
  type: stdio
  command: npx
  args:
    - "-y"
    - "@modelcontextprotocol/server-brave-search"
  env:
    BRAVE_API_KEY: "${BRAVE_API_KEY}"
  container:
    enabled: true
    network: bridge

name: "Brave Search (subprocess)"
description: "Web search using Brave's search API. Requires a Brave API key. Runs as a subprocess via npx."

brave-search:
  type: stdio
  command: npx
  args:
    - "-y"
    - "@modelcontextprotocol/server-brave-search"
  env:
    BRAVE_API_KEY: "${BRAVE_API_KEY}"

name: "Context7 (containerized)"
description: "Up-to-date library documentation via Context7. Runs in a container with outbound network access for API calls."

context7:
  type: stdio
  command: npx
  args:
    - "-y"
    - "@upstash/context7-mcp"
    - "--api-key"
    - "${CONTEXT7_API_KEY}"
  container:
    enabled: true
    network: bridge

name: "Context7 (subprocess)"
description: "Up-to-date library documentation and code examples via the Context7 MCP server. Requires a Context7 API key."

context7:
  type: stdio
  command: npx
  args:
    - "-y"
    - "@upstash/context7-mcp"
    - "--api-key"
    - "${CONTEXT7_API_KEY}"

name: "Exa Search (containerized)"
description: "Semantic web search powered by Exa AI. Runs in a container with outbound network access."
# Secrets: EXA_API_KEY — set with: argus-mcp secrets set EXA_API_KEY <your-exa-api-key>
# Get key at: https://dashboard.exa.ai/api-keys

exa-container:
  type: stdio
  command: npx
  args:
    - "-y"
    - "exa-mcp-server"
  env:
    EXA_API_KEY: "${EXA_API_KEY}"
  container:
    enabled: true
    network: bridge

name: "Exa Search"
description: "Semantic web search powered by Exa AI. Runs as a subprocess."
# Secrets: EXA_API_KEY — set with: argus-mcp secrets set EXA_API_KEY <your-exa-api-key>
# Get key at: https://dashboard.exa.ai/api-keys

exa:
  type: stdio
  command: npx
  args:
    - "-y"
    - "exa-mcp-server"
  env:
    EXA_API_KEY: "${EXA_API_KEY}"

name: "Fetch Server (containerized)"
description: "Fetch and convert web pages to Markdown. Runs in a container with outbound network access."

fetch:
  type: stdio
  command: uvx
  args:
    - "mcp-server-fetch"
  container:
    enabled: true
    network: bridge

name: "Fetch Server (subprocess)"
description: "Fetch web pages and convert them to Markdown for LLM consumption. Runs as a subprocess via uvx."

fetch:
  type: stdio
  command: uvx
  args:
    - "mcp-server-fetch"

name: "Web Research MCP (containerized)"
description: "Deep web research with real-time page fetching and content extraction. Built from source on GitHub — no npm package available. Runs in a container with outbound network access."
# Demonstrates: container.source_url + build_steps + entrypoint for GitHub-only servers
# No API keys required — uses public web access only
# Source: https://github.com/mzxrai/mcp-webresearch

mcp-webresearch-container:
  type: stdio
  command: node
  args:
    - "dist/index.js"
  container:
    enabled: true
    network: bridge
    source_url: https://github.com/mzxrai/mcp-webresearch.git
    build_steps:
      - "npm install"
      - "npm run build"
    entrypoint:
      - "node"
      - "dist/index.js"

name: "Playwright MCP (containerized)"
description: "Browser automation and web scraping via Playwright. Runs in a container with system browser dependencies installed."
# Demonstrates: container.system_deps for OS-level packages (chromium)
# No secrets required for basic use

playwright-container:
  type: stdio
  command: npx
  args:
    - "-y"
    - "@playwright/mcp"
  container:
    enabled: true
    network: bridge
    system_deps:
      - "chromium"
      - "chromium-chromedriver"
      - "dbus"
      - "dbus-x11"
      - "xvfb"