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
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.