Type to search the docs and updates.

Browse documentation

MCP recipes

Copy a recipe into .agnostic-ai/mcps/<name>.yaml (or the directory sources.mcps sets). Replace example paths, and export each ${NAME} variable before you start your coding tool. Run agnostic-ai lint and agnostic-ai sync, then confirm the server connects in the tool.

The recipes were checked on 2026-10-03; compare each with its linked source. MCP servers lists the fields, and environment references the values each tool cannot read.

GitHub (remote)

Source: github/github-mcp-server, remote server and its README.

name: github
description: GitHub issues, pull requests, and repositories.
type: http
url: https://api.githubcopilot.com/mcp/
headers:
  Authorization: Bearer ${GITHUB_PAT}

Create a personal access token on GitHub and export it as GITHUB_PAT.

Keep it personal

A shared spec uses each person's own ${GITHUB_PAT} without storing the token. If only you want the server, save the spec as .agnostic-ai/local/mcps/github.yaml, whatever sources.mcps says. Local files stay out of version control, so teammates who want it add their own.

Details: keeping a server off
  • A local file still loads, so it does not turn the server off.
  • To keep a server off, leave it out of every spec that loads, or turn it off in the tool.
  • disabled: true does not work on every tool (disabled support by target).

Context7 (remote)

Source: upstash/context7.

name: context7
description: Current library documentation for the model.
type: http
url: https://mcp.context7.com/mcp
headers:
  Authorization: Bearer ${CONTEXT7_API_KEY}

A free key from the Context7 dashboard raises the rate limit.

Playwright

Source: microsoft/playwright-mcp.

name: playwright
description: Drive a browser with Playwright.
command: npx
args:
  - "@playwright/mcp@latest"

Filesystem

Source: modelcontextprotocol/servers, filesystem.

name: filesystem
description: Read and write files in the listed directories.
command: npx
args:
  - -y
  - "@modelcontextprotocol/server-filesystem"
  - /path/to/allowed/dir

Each path after the package name is a directory the server may reach.