oh-my-opencode/src/mcp/AGENTS.md

MCP KNOWLEDGE BASE

OVERVIEW

Tier 1 of three-tier MCP system: 8 built-in remote HTTP MCPs.

Three-Tier System:

1. Built-in (this directory): websearch, context7, grep_app
2. Claude Code compat: .mcp.json with ${VAR} expansion
3. Skill-embedded: YAML frontmatter in skills

STRUCTURE

mcp/
├── index.ts        # createBuiltinMcps() factory
├── websearch.ts    # Exa AI / Tavily web search
├── context7.ts     # Library documentation
├── grep-app.ts     # GitHub code search
├── types.ts        # McpNameSchema
└── index.test.ts   # Tests

MCP SERVERS

Name	URL	Purpose	Auth
websearch	mcp.exa.ai / mcp.tavily.com	Real-time web search	EXA_API_KEY / TAVILY_API_KEY
context7	mcp.context7.com/mcp	Library docs	CONTEXT7_API_KEY (optional)
grep_app	mcp.grep.app	GitHub code search	None

Websearch Provider Configuration

Provider	URL	Auth	API Key Required
exa (default)	mcp.exa.ai	x-api-key header	No (optional)
tavily	mcp.tavily.com	Authorization Bearer	Yes

{
  "websearch": {
    "provider": "tavily"  // or "exa" (default)
  }
}

CONFIG PATTERN

export const mcp_name = {
  type: "remote" as const,
  url: "https://...",
  enabled: true,
  oauth: false as const,
  headers?: { ... },
}

HOW TO ADD

1. Create src/mcp/my-mcp.ts
2. Add to allBuiltinMcps in index.ts
3. Add to McpNameSchema in types.ts

NOTES

• Remote only: HTTP/SSE, no stdio
• Disable: User can set disabled_mcps: ["name"] in config
• Exa: Default provider, works without API key
• Tavily: Requires TAVILY_API_KEY env var