Skip to content
AgentAtlas

Amp AGENTS.md, settings.json and MCP

How does Amp load AGENTS.md files, where is settings.json, and how do I add MCP servers?

Amp always loads AGENTS.md from the working directory and its parents, plus your personal and system-wide files, and pulls in subtree AGENTS.md files when it reads files there. User settings live in ~/.config/amp/settings.json, workspace settings in the nearest .amp/settings.json, and every key uses the amp. prefix. Add MCP servers with amp mcp add or the amp.mcpServers setting.

Compare: settings file locations in every AI coding agent →

How Amp finds AGENTS.md

  • AGENTS.md in the current working directory (or editor workspace roots) and parent directories up to $HOME is always included.
  • AGENTS.md files in subtrees are included when the agent reads a file in that subtree.
  • $HOME/.config/amp/AGENTS.md and $HOME/.config/AGENTS.md are always included if they exist.
  • System-wide files are always included: /etc/ampcode/AGENTS.md on Linux, /Library/Application Support/ampcode/AGENTS.md on macOS, %ProgramData%\ampcode\AGENTS.md on Windows.
  • If a directory has no AGENTS.md but has AGENT.md or CLAUDE.md, that file is used instead.

Set AMP_IGNORE_GUIDANCE_FILES to a colon-separated list of globs to skip matching files, or to * to skip all of them.

@-mentions and glob-scoped guidance

Mention other files with @ inside an AGENTS.md to include them. Relative paths resolve from the file that contains the mention, absolute paths and @~/ paths work, glob patterns such as @doc/*.md are supported, and mentions inside code blocks are ignored.

A mentioned file can carry globs in YAML front matter. It is then included only after Amp has read a file matching one of the globs. Globs get an implicit **/ prefix unless they start with ./ or ../.

docs/typescript-conventions.md

---
globs:
  - '**/*.ts'
  - '**/*.tsx'
---
Follow these TypeScript conventions:
- Never use the any type

settings.json and key settings

User settings are at ~/.config/amp/settings.json (or settings.jsonc) on macOS and Linux, and %USERPROFILE%\.config\amp\settings.json on Windows. Workspace settings are the nearest .amp/settings.json, searched upward to the repository root, and they override user settings. Run amp config edit to open user settings, or add --workspace for workspace settings.

  • amp.mcpServers: local MCP server definitions.
  • amp.mcpPermissions: ordered allow or reject rules that match MCP servers by command and args or by url. The first match wins and unmatched servers are allowed.
  • amp.tools.disable: tool names to disable, with builtin: prefixes and * globs supported.
  • amp.skills.path: extra skill directories.
  • amp.showCosts, amp.updates.mode and amp.git.commit.coauthor.enabled for costs, updates and commit trailers.

Amp does not ask for approval before running tools. To control tool use, the docs point you to a custom plugin, which workspace admins can distribute as a global workspace plugin.

MCP servers, modes and execute mode

Add a local or URL-based MCP server from the CLI, or define it in amp.mcpServers using command, args and env for local servers or url and headers for remote ones. Use ${VAR_NAME} for environment variables. The docs recommend bundling MCP servers in skills where possible so tools load only when needed.

Add MCP servers

amp mcp add context7 -- npx -y @upstash/context7-mcp
amp mcp add linear https://mcp.linear.app/sse

Modes are set on The Dial: low, medium (the default), high and ultra. A thread keeps the mode chosen before its first message. In the CLI, press Ctrl+S before your first message to change it.

Execute mode runs one prompt, prints the final message and exits. Start it with -x or --execute, or by redirecting stdout. You can also pipe input into amp -x to supply the prompt. For CI, set AMP_API_KEY to an access token from Settings.

Execute mode

amp -x "what package manager is used here?"
cat README.md | amp -x "summarize this file"
amp --mcp-config '{"everything": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-everything"]}}' -x "What tools are available to you?"

Sources

More Amp guides

Reviewed Oct 18, 2026. Settings change often; the linked vendor docs are the source of truth.

Built an MCP server? Get it listed everywhere →

Shipping an Android app? Google Play needs 12 testers for 14 days first. Get them with Tester Exchange →