MCP System

// 1. Resolve library ID
const result = await context7_resolve-library-id("react-query")
// { id: "tanstack-query" }

// 2. Query specific topic
await context7_query-docs(
  libraryId: "tanstack-query",
  query: "useQuery hook options"
)

{
  query: string,           // Search query
  language?: string[],     // Filter by language ["TypeScript", "JavaScript"]
  repo?: string,           // Specific repo "owner/name"
  useRegexp?: boolean      // Enable regex search
}

// Basic search
await grep_app_searchGitHub({
  query: "useQuery(",
  language: ["TypeScript"]
})

// Regex search
await grep_app_searchGitHub({
  query: "function\\s+\\w+Hook",
  useRegexp: true
})

// Specific repo
await grep_app_searchGitHub({
  query: "createContext",
  repo: "facebook/react"
})

{
  "disabled_mcps": [
    "websearch",  // Disable web search
    "context7",   // Disable library docs
    "grep_app"    // Disable GitHub search
  ]
}

// .mcp.json
{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["./server.js"],
      "env": {
        "API_KEY": "${MY_API_KEY}",  // Env var expansion
        "NODE_ENV": "production"
      }
    },
    "remote-server": {
      "url": "https://mcp.example.com/server",
      "headers": {
        "Authorization": "Bearer ${AUTH_TOKEN}"
      }
    }
  }
}

// Example .mcp.json
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_URL": "${POSTGRES_URL}",
        "LOG_LEVEL": "${LOG_LEVEL:-info}"  // Defaults to "info"
      }
    }
  }
}

---
name: my-skill
description: Skill with embedded MCP
mcpServers:
  playwright:
    command: npx
    args: ["@playwright/mcp@latest"]
  custom-server:
    url: https://mcp.example.com/api
    headers:
      Authorization: Bearer ${API_TOKEN}
---

# Skill Content

export class SkillMcpManager {
  // Get or create client for session
  async getOrCreateClient(
    info: SkillMcpClientInfo,
    config: ClaudeCodeMcpServer
  ): Promise<Client>

  // List available tools
  async listTools(info, context): Promise<Tool[]>

  // Call MCP tool
  async callTool(
    info: SkillMcpClientInfo,
    context: SkillMcpServerContext,
    name: string,
    args: Record<string, unknown>
  ): Promise<unknown>

  // Cleanup on session end
  async disconnectSession(sessionID: string): Promise<void>
  async disconnectAll(): Promise<void>
}

# SKILL.md with OAuth
mcpServers:
  oauth-server:
    url: https://api.example.com/mcp
    oauth:
      authorizationUrl: https://auth.example.com/authorize
      tokenUrl: https://auth.example.com/token
      clientId: ${OAUTH_CLIENT_ID}
      clientSecret: ${OAUTH_CLIENT_SECRET}
      scope: read write
      usePKCE: true

{
  "agents": {
    "librarian": {
      "permission": {
        "grep_app_*": "allow",     // Allow all grep_app tools
        "websearch_*": "allow",    // Allow all websearch tools
        "context7_*": "allow"      // Allow all context7 tools
      }
    },
    "sisyphus": {
      "permission": {
        "grep_app_*": false,       // Deny grep_app
        "websearch_*": "allow"     // Allow websearch
      }
    }
  }
}

bunx oh-my-opencode doctor