[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MFABSPBCRVWEH1NQRF9PN7":3,"skill-same:01M6MFABSPBCRVWEH1NQRF9PN7":78},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":44,"linkOnly":45,"markdownContent":46,"markdownBody":47,"frontMatter":48,"refName":57,"commitSha":58,"skillDirectory":59,"forksCount":60,"repositoryHtmlUrl":61,"repositoryHomepageUrl":6,"ownerHtmlUrl":62,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":63,"install":64,"resources":77},"01M6MFABSPBCRVWEH1NQRF9PN7","native-mcp",null,"Built-in MCP (Model Context Protocol) client that connects to external MCP servers, discovers their tools, and registers them as native Hermes Agent tools. Supports stdio and HTTP transports with automatic reconnection, security filtering, and zero-config tool injection.","ibragimov-oasis\u002Fvibe-coder","ibragimov-oasis","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F240665573?v=4","01M6DF78Y45R8228FHAZ7G6JXM","IBRAGIMOV MUKHAMMADJON","01M6K5ZYR8TDPAFG4R6693E2A6",3,"MIT","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002FREPO_DOCS\u002F02-hermes-agent\u002Fskills\u002Fmcp\u002Fnative-mcp\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43],"native","native mcp","MCP","model","automatic","with","as","agent tools","filtering","context","integrations","tool","injection","Tools","ZeRO","protocol","http","config","model context protocol","security","2026-11-10 10:12:30",false,"---\nname: native-mcp\ndescription: Built-in MCP (Model Context Protocol) client that connects to external MCP servers, discovers their tools, and registers them as native Hermes Agent tools. Supports stdio and HTTP transports with automatic reconnection, security filtering, and zero-config tool injection.\nversion: 1.0.0\nauthor: Hermes Agent\nlicense: MIT\nmetadata:\n  hermes:\n    tags: [MCP, Tools, Integrations]\n    related_skills: [mcporter]\n---\n\n# Native MCP Client\n\nHermes Agent has a built-in MCP client that connects to MCP servers at startup, discovers their tools, and makes them available as first-class tools the agent can call directly. No bridge CLI needed -- tools from MCP servers appear alongside built-in tools like `terminal`, `read_file`, etc.\n\n## When to Use\n\nUse this whenever you want to:\n- Connect to MCP servers and use their tools from within Hermes Agent\n- Add external capabilities (filesystem access, GitHub, databases, APIs) via MCP\n- Run local stdio-based MCP servers (npx, uvx, or any command)\n- Connect to remote HTTP\u002FStreamableHTTP MCP servers\n- Have MCP tools auto-discovered and available in every conversation\n\nFor ad-hoc, one-off MCP tool calls from the terminal without configuring anything, see the `mcporter` skill instead.\n\n## Prerequisites\n\n- **mcp Python package** -- optional dependency; install with `pip install mcp`. If not installed, MCP support is silently disabled.\n- **Node.js** -- required for `npx`-based MCP servers (most community servers)\n- **uv** -- required for `uvx`-based MCP servers (Python-based servers)\n\nInstall the MCP SDK:\n\n```bash\npip install mcp\n# or, if using uv:\nuv pip install mcp\n```\n\n## Quick Start\n\nAdd MCP servers to `~\u002F.hermes\u002Fconfig.yaml` under the `mcp_servers` key:\n\n```yaml\nmcp_servers:\n  time:\n    command: \"uvx\"\n    args: [\"mcp-server-time\"]\n```\n\nRestart Hermes Agent. On startup it will:\n1. Connect to the server\n2. Discover available tools\n3. Register them with the prefix `mcp_time_*`\n4. Inject them into all platform toolsets\n\nYou can then use the tools naturally -- just ask the agent to get the current time.\n\n## Configuration Reference\n\nEach entry under `mcp_servers` is a server name mapped to its config. There are two transport types: **stdio** (command-based) and **HTTP** (url-based).\n\n### Stdio Transport (command + args)\n\n```yaml\nmcp_servers:\n  server_name:\n    command: \"npx\"             # (required) executable to run\n    args: [\"-y\", \"pkg-name\"]   # (optional) command arguments, default: []\n    env:                       # (optional) environment variables for the subprocess\n      SOME_API_KEY: \"value\"\n    timeout: 120               # (optional) per-tool-call timeout in seconds, default: 120\n    connect_timeout: 60        # (optional) initial connection timeout in seconds, default: 60\n```\n\n### HTTP Transport (url)\n\n```yaml\nmcp_servers:\n  server_name:\n    url: \"https:\u002F\u002Fmy-server.example.com\u002Fmcp\"   # (required) server URL\n    headers:                                     # (optional) HTTP headers\n      Authorization: \"Bearer sk-...\"\n    timeout: 180               # (optional) per-tool-call timeout in seconds, default: 120\n    connect_timeout: 60        # (optional) initial connection timeout in seconds, default: 60\n```\n\n### All Config Options\n\n| Option            | Type   | Default | Description                                       |\n|-------------------|--------|---------|---------------------------------------------------|\n| `command`         | string | --      | Executable to run (stdio transport, required)     |\n| `args`            | list   | `[]`    | Arguments passed to the command                   |\n| `env`             | dict   | `{}`    | Extra environment variables for the subprocess    |\n| `url`             | string | --      | Server URL (HTTP transport, required)             |\n| `headers`         | dict   | `{}`    | HTTP headers sent with every request              |\n| `timeout`         | int    | `120`   | Per-tool-call timeout in seconds                  |\n| `connect_timeout` | int    | `60`    | Timeout for initial connection and discovery      |\n\nNote: A server config must have either `command` (stdio) or `url` (HTTP), not both.\n\n## How It Works\n\n### Startup Discovery\n\nWhen Hermes Agent starts, `discover_mcp_tools()` is called during tool initialization:\n\n1. Reads `mcp_servers` from `~\u002F.hermes\u002Fconfig.yaml`\n2. For each server, spawns a connection in a dedicated background event loop\n3. Initializes the MCP session and calls `list_tools()` to discover available tools\n4. Registers each tool in the Hermes tool registry\n\n### Tool Naming Convention\n\nMCP tools are registered with the naming pattern:\n\n```\nmcp_{server_name}_{tool_name}\n```\n\nHyphens and dots in names are replaced with underscores for LLM API compatibility.\n\nExamples:\n- Server `filesystem`, tool `read_file` → `mcp_filesystem_read_file`\n- Server `github`, tool `list-issues` → `mcp_github_list_issues`\n- Server `my-api`, tool `fetch.data` → `mcp_my_api_fetch_data`\n\n### Auto-Injection\n\nAfter discovery, MCP tools are automatically injected into all `hermes-*` platform toolsets (CLI, Discord, Telegram, etc.). This means MCP tools are available in every conversation without any additional configuration.\n\n### Connection Lifecycle\n\n- Each server runs as a long-lived asyncio Task in a background daemon thread\n- Connections persist for the lifetime of the agent process\n- If a connection drops, automatic reconnection with exponential backoff kicks in (up to 5 retries, max 60s backoff)\n- On agent shutdown, all connections are gracefully closed\n\n### Idempotency\n\n`discover_mcp_tools()` is idempotent -- calling it multiple times only connects to servers that aren't already connected. Failed servers are retried on subsequent calls.\n\n## Transport Types\n\n### Stdio Transport\n\nThe most common transport. Hermes launches the MCP server as a subprocess and communicates over stdin\u002Fstdout.\n\n```yaml\nmcp_servers:\n  filesystem:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Fhome\u002Fuser\u002Fprojects\"]\n```\n\nThe subprocess inherits a **filtered** environment (see Security section below) plus any variables you specify in `env`.\n\n### HTTP \u002F StreamableHTTP Transport\n\nFor remote or shared MCP servers. Requires the `mcp` package to include HTTP client support (`mcp.client.streamable_http`).\n\n```yaml\nmcp_servers:\n  remote_api:\n    url: \"https:\u002F\u002Fmcp.example.com\u002Fmcp\"\n    headers:\n      Authorization: \"Bearer sk-...\"\n```\n\nIf HTTP support is not available in your installed `mcp` version, the server will fail with an ImportError and other servers will continue normally.\n\n## Security\n\n### Environment Variable Filtering\n\nFor stdio servers, Hermes does NOT pass your full shell environment to MCP subprocesses. Only safe baseline variables are inherited:\n\n- `PATH`, `HOME`, `USER`, `LANG`, `LC_ALL`, `TERM`, `SHELL`, `TMPDIR`\n- Any `XDG_*` variables\n\nAll other environment variables (API keys, tokens, secrets) are excluded unless you explicitly add them via the `env` config key. This prevents accidental credential leakage to untrusted MCP servers.\n\n```yaml\nmcp_servers:\n  github:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-github\"]\n    env:\n      # Only this token is passed to the subprocess\n      GITHUB_PERSONAL_ACCESS_TOKEN: \"ghp_...\"\n```\n\n### Credential Stripping in Error Messages\n\nIf an MCP tool call fails, any credential-like patterns in the error message are automatically redacted before being shown to the LLM. This covers:\n\n- GitHub PATs (`ghp_...`)\n- OpenAI-style keys (`sk-...`)\n- Bearer tokens\n- Generic `token=`, `key=`, `API_KEY=`, `password=`, `secret=` patterns\n\n## Troubleshooting\n\n### \"MCP SDK not available -- skipping MCP tool discovery\"\n\nThe `mcp` Python package is not installed. Install it:\n\n```bash\npip install mcp\n```\n\n### \"No MCP servers configured\"\n\nNo `mcp_servers` key in `~\u002F.hermes\u002Fconfig.yaml`, or it's empty. Add at least one server.\n\n### \"Failed to connect to MCP server 'X'\"\n\nCommon causes:\n- **Command not found**: The `command` binary isn't on PATH. Ensure `npx`, `uvx`, or the relevant command is installed.\n- **Package not found**: For npx servers, the npm package may not exist or may need `-y` in args to auto-install.\n- **Timeout**: The server took too long to start. Increase `connect_timeout`.\n- **Port conflict**: For HTTP servers, the URL may be unreachable.\n\n### \"MCP server 'X' requires HTTP transport but mcp.client.streamable_http is not available\"\n\nYour `mcp` package version doesn't include HTTP client support. Upgrade:\n\n```bash\npip install --upgrade mcp\n```\n\n### Tools not appearing\n\n- Check that the server is listed under `mcp_servers` (not `mcp` or `servers`)\n- Ensure the YAML indentation is correct\n- Look at Hermes Agent startup logs for connection messages\n- Tool names are prefixed with `mcp_{server}_{tool}` -- look for that pattern\n\n### Connection keeps dropping\n\nThe client retries up to 5 times with exponential backoff (1s, 2s, 4s, 8s, 16s, capped at 60s). If the server is fundamentally unreachable, it gives up after 5 attempts. Check the server process and network connectivity.\n\n## Examples\n\n### Time Server (uvx)\n\n```yaml\nmcp_servers:\n  time:\n    command: \"uvx\"\n    args: [\"mcp-server-time\"]\n```\n\nRegisters tools like `mcp_time_get_current_time`.\n\n### Filesystem Server (npx)\n\n```yaml\nmcp_servers:\n  filesystem:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Fhome\u002Fuser\u002Fdocuments\"]\n    timeout: 30\n```\n\nRegisters tools like `mcp_filesystem_read_file`, `mcp_filesystem_write_file`, `mcp_filesystem_list_directory`.\n\n### GitHub Server with Authentication\n\n```yaml\nmcp_servers:\n  github:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-github\"]\n    env:\n      GITHUB_PERSONAL_ACCESS_TOKEN: \"ghp_xxxxxxxxxxxxxxxxxxxx\"\n    timeout: 60\n```\n\nRegisters tools like `mcp_github_list_issues`, `mcp_github_create_pull_request`, etc.\n\n### Remote HTTP Server\n\n```yaml\nmcp_servers:\n  company_api:\n    url: \"https:\u002F\u002Fmcp.mycompany.com\u002Fv1\u002Fmcp\"\n    headers:\n      Authorization: \"Bearer sk-xxxxxxxxxxxxxxxxxxxx\"\n      X-Team-Id: \"engineering\"\n    timeout: 180\n    connect_timeout: 30\n```\n\n### Multiple Servers\n\n```yaml\nmcp_servers:\n  time:\n    command: \"uvx\"\n    args: [\"mcp-server-time\"]\n\n  filesystem:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Ftmp\"]\n\n  github:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-github\"]\n    env:\n      GITHUB_PERSONAL_ACCESS_TOKEN: \"ghp_xxxxxxxxxxxxxxxxxxxx\"\n\n  company_api:\n    url: \"https:\u002F\u002Fmcp.internal.company.com\u002Fmcp\"\n    headers:\n      Authorization: \"Bearer sk-xxxxxxxxxxxxxxxxxxxx\"\n    timeout: 300\n```\n\nAll tools from all servers are registered and available simultaneously. Each server's tools are prefixed with its name to avoid collisions.\n\n## Sampling (Server-Initiated LLM Requests)\n\nHermes supports MCP's `sampling\u002FcreateMessage` capability — MCP servers can request LLM completions through the agent during tool execution. This enables agent-in-the-loop workflows (data analysis, content generation, decision-making).\n\nSampling is **enabled by default**. Configure per server:\n\n```yaml\nmcp_servers:\n  my_server:\n    command: \"npx\"\n    args: [\"-y\", \"my-mcp-server\"]\n    sampling:\n      enabled: true           # default: true\n\n      max_tokens_cap: 4096    # max tokens per request\n      timeout: 30             # LLM call timeout (seconds)\n      max_rpm: 10             # max requests per minute\n      allowed_models: []      # model whitelist (empty = all)\n      max_tool_rounds: 5      # tool loop limit (0 = disable)\n      log_level: \"info\"       # audit verbosity\n```\n\nServers can also include `tools` in sampling requests for multi-turn tool-augmented workflows. The `max_tool_rounds` config prevents infinite tool loops. Per-server audit metrics (requests, errors, tokens, tool use count) are tracked via `get_mcp_status()`.\n\nDisable sampling for untrusted servers with `sampling: { enabled: false }`.\n\n## Notes\n\n- MCP tools are called synchronously from the agent's perspective but run asynchronously on a dedicated background event loop\n- Tool results are returned as JSON with either `{\"result\": \"...\"}` or `{\"error\": \"...\"}`\n- The native MCP client is independent of `mcporter` -- you can use both simultaneously\n- Server connections are persistent and shared across all conversations in the same agent process\n- Adding or removing servers requires restarting the agent (no hot-reload currently)\n\n## ? Связи\n\n- [[000 - Map of Maps]] — REPO_DOCS\n- [[000 - Map of Maps]] — Map of Maps\n\n","# Native MCP Client\n\nHermes Agent has a built-in MCP client that connects to MCP servers at startup, discovers their tools, and makes them available as first-class tools the agent can call directly. No bridge CLI needed -- tools from MCP servers appear alongside built-in tools like `terminal`, `read_file`, etc.\n\n## When to Use\n\nUse this whenever you want to:\n- Connect to MCP servers and use their tools from within Hermes Agent\n- Add external capabilities (filesystem access, GitHub, databases, APIs) via MCP\n- Run local stdio-based MCP servers (npx, uvx, or any command)\n- Connect to remote HTTP\u002FStreamableHTTP MCP servers\n- Have MCP tools auto-discovered and available in every conversation\n\nFor ad-hoc, one-off MCP tool calls from the terminal without configuring anything, see the `mcporter` skill instead.\n\n## Prerequisites\n\n- **mcp Python package** -- optional dependency; install with `pip install mcp`. If not installed, MCP support is silently disabled.\n- **Node.js** -- required for `npx`-based MCP servers (most community servers)\n- **uv** -- required for `uvx`-based MCP servers (Python-based servers)\n\nInstall the MCP SDK:\n\n```bash\npip install mcp\n# or, if using uv:\nuv pip install mcp\n```\n\n## Quick Start\n\nAdd MCP servers to `~\u002F.hermes\u002Fconfig.yaml` under the `mcp_servers` key:\n\n```yaml\nmcp_servers:\n  time:\n    command: \"uvx\"\n    args: [\"mcp-server-time\"]\n```\n\nRestart Hermes Agent. On startup it will:\n1. Connect to the server\n2. Discover available tools\n3. Register them with the prefix `mcp_time_*`\n4. Inject them into all platform toolsets\n\nYou can then use the tools naturally -- just ask the agent to get the current time.\n\n## Configuration Reference\n\nEach entry under `mcp_servers` is a server name mapped to its config. There are two transport types: **stdio** (command-based) and **HTTP** (url-based).\n\n### Stdio Transport (command + args)\n\n```yaml\nmcp_servers:\n  server_name:\n    command: \"npx\"             # (required) executable to run\n    args: [\"-y\", \"pkg-name\"]   # (optional) command arguments, default: []\n    env:                       # (optional) environment variables for the subprocess\n      SOME_API_KEY: \"value\"\n    timeout: 120               # (optional) per-tool-call timeout in seconds, default: 120\n    connect_timeout: 60        # (optional) initial connection timeout in seconds, default: 60\n```\n\n### HTTP Transport (url)\n\n```yaml\nmcp_servers:\n  server_name:\n    url: \"https:\u002F\u002Fmy-server.example.com\u002Fmcp\"   # (required) server URL\n    headers:                                     # (optional) HTTP headers\n      Authorization: \"Bearer sk-...\"\n    timeout: 180               # (optional) per-tool-call timeout in seconds, default: 120\n    connect_timeout: 60        # (optional) initial connection timeout in seconds, default: 60\n```\n\n### All Config Options\n\n| Option            | Type   | Default | Description                                       |\n|-------------------|--------|---------|---------------------------------------------------|\n| `command`         | string | --      | Executable to run (stdio transport, required)     |\n| `args`            | list   | `[]`    | Arguments passed to the command                   |\n| `env`             | dict   | `{}`    | Extra environment variables for the subprocess    |\n| `url`             | string | --      | Server URL (HTTP transport, required)             |\n| `headers`         | dict   | `{}`    | HTTP headers sent with every request              |\n| `timeout`         | int    | `120`   | Per-tool-call timeout in seconds                  |\n| `connect_timeout` | int    | `60`    | Timeout for initial connection and discovery      |\n\nNote: A server config must have either `command` (stdio) or `url` (HTTP), not both.\n\n## How It Works\n\n### Startup Discovery\n\nWhen Hermes Agent starts, `discover_mcp_tools()` is called during tool initialization:\n\n1. Reads `mcp_servers` from `~\u002F.hermes\u002Fconfig.yaml`\n2. For each server, spawns a connection in a dedicated background event loop\n3. Initializes the MCP session and calls `list_tools()` to discover available tools\n4. Registers each tool in the Hermes tool registry\n\n### Tool Naming Convention\n\nMCP tools are registered with the naming pattern:\n\n```\nmcp_{server_name}_{tool_name}\n```\n\nHyphens and dots in names are replaced with underscores for LLM API compatibility.\n\nExamples:\n- Server `filesystem`, tool `read_file` → `mcp_filesystem_read_file`\n- Server `github`, tool `list-issues` → `mcp_github_list_issues`\n- Server `my-api`, tool `fetch.data` → `mcp_my_api_fetch_data`\n\n### Auto-Injection\n\nAfter discovery, MCP tools are automatically injected into all `hermes-*` platform toolsets (CLI, Discord, Telegram, etc.). This means MCP tools are available in every conversation without any additional configuration.\n\n### Connection Lifecycle\n\n- Each server runs as a long-lived asyncio Task in a background daemon thread\n- Connections persist for the lifetime of the agent process\n- If a connection drops, automatic reconnection with exponential backoff kicks in (up to 5 retries, max 60s backoff)\n- On agent shutdown, all connections are gracefully closed\n\n### Idempotency\n\n`discover_mcp_tools()` is idempotent -- calling it multiple times only connects to servers that aren't already connected. Failed servers are retried on subsequent calls.\n\n## Transport Types\n\n### Stdio Transport\n\nThe most common transport. Hermes launches the MCP server as a subprocess and communicates over stdin\u002Fstdout.\n\n```yaml\nmcp_servers:\n  filesystem:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Fhome\u002Fuser\u002Fprojects\"]\n```\n\nThe subprocess inherits a **filtered** environment (see Security section below) plus any variables you specify in `env`.\n\n### HTTP \u002F StreamableHTTP Transport\n\nFor remote or shared MCP servers. Requires the `mcp` package to include HTTP client support (`mcp.client.streamable_http`).\n\n```yaml\nmcp_servers:\n  remote_api:\n    url: \"https:\u002F\u002Fmcp.example.com\u002Fmcp\"\n    headers:\n      Authorization: \"Bearer sk-...\"\n```\n\nIf HTTP support is not available in your installed `mcp` version, the server will fail with an ImportError and other servers will continue normally.\n\n## Security\n\n### Environment Variable Filtering\n\nFor stdio servers, Hermes does NOT pass your full shell environment to MCP subprocesses. Only safe baseline variables are inherited:\n\n- `PATH`, `HOME`, `USER`, `LANG`, `LC_ALL`, `TERM`, `SHELL`, `TMPDIR`\n- Any `XDG_*` variables\n\nAll other environment variables (API keys, tokens, secrets) are excluded unless you explicitly add them via the `env` config key. This prevents accidental credential leakage to untrusted MCP servers.\n\n```yaml\nmcp_servers:\n  github:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-github\"]\n    env:\n      # Only this token is passed to the subprocess\n      GITHUB_PERSONAL_ACCESS_TOKEN: \"ghp_...\"\n```\n\n### Credential Stripping in Error Messages\n\nIf an MCP tool call fails, any credential-like patterns in the error message are automatically redacted before being shown to the LLM. This covers:\n\n- GitHub PATs (`ghp_...`)\n- OpenAI-style keys (`sk-...`)\n- Bearer tokens\n- Generic `token=`, `key=`, `API_KEY=`, `password=`, `secret=` patterns\n\n## Troubleshooting\n\n### \"MCP SDK not available -- skipping MCP tool discovery\"\n\nThe `mcp` Python package is not installed. Install it:\n\n```bash\npip install mcp\n```\n\n### \"No MCP servers configured\"\n\nNo `mcp_servers` key in `~\u002F.hermes\u002Fconfig.yaml`, or it's empty. Add at least one server.\n\n### \"Failed to connect to MCP server 'X'\"\n\nCommon causes:\n- **Command not found**: The `command` binary isn't on PATH. Ensure `npx`, `uvx`, or the relevant command is installed.\n- **Package not found**: For npx servers, the npm package may not exist or may need `-y` in args to auto-install.\n- **Timeout**: The server took too long to start. Increase `connect_timeout`.\n- **Port conflict**: For HTTP servers, the URL may be unreachable.\n\n### \"MCP server 'X' requires HTTP transport but mcp.client.streamable_http is not available\"\n\nYour `mcp` package version doesn't include HTTP client support. Upgrade:\n\n```bash\npip install --upgrade mcp\n```\n\n### Tools not appearing\n\n- Check that the server is listed under `mcp_servers` (not `mcp` or `servers`)\n- Ensure the YAML indentation is correct\n- Look at Hermes Agent startup logs for connection messages\n- Tool names are prefixed with `mcp_{server}_{tool}` -- look for that pattern\n\n### Connection keeps dropping\n\nThe client retries up to 5 times with exponential backoff (1s, 2s, 4s, 8s, 16s, capped at 60s). If the server is fundamentally unreachable, it gives up after 5 attempts. Check the server process and network connectivity.\n\n## Examples\n\n### Time Server (uvx)\n\n```yaml\nmcp_servers:\n  time:\n    command: \"uvx\"\n    args: [\"mcp-server-time\"]\n```\n\nRegisters tools like `mcp_time_get_current_time`.\n\n### Filesystem Server (npx)\n\n```yaml\nmcp_servers:\n  filesystem:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Fhome\u002Fuser\u002Fdocuments\"]\n    timeout: 30\n```\n\nRegisters tools like `mcp_filesystem_read_file`, `mcp_filesystem_write_file`, `mcp_filesystem_list_directory`.\n\n### GitHub Server with Authentication\n\n```yaml\nmcp_servers:\n  github:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-github\"]\n    env:\n      GITHUB_PERSONAL_ACCESS_TOKEN: \"ghp_xxxxxxxxxxxxxxxxxxxx\"\n    timeout: 60\n```\n\nRegisters tools like `mcp_github_list_issues`, `mcp_github_create_pull_request`, etc.\n\n### Remote HTTP Server\n\n```yaml\nmcp_servers:\n  company_api:\n    url: \"https:\u002F\u002Fmcp.mycompany.com\u002Fv1\u002Fmcp\"\n    headers:\n      Authorization: \"Bearer sk-xxxxxxxxxxxxxxxxxxxx\"\n      X-Team-Id: \"engineering\"\n    timeout: 180\n    connect_timeout: 30\n```\n\n### Multiple Servers\n\n```yaml\nmcp_servers:\n  time:\n    command: \"uvx\"\n    args: [\"mcp-server-time\"]\n\n  filesystem:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \"\u002Ftmp\"]\n\n  github:\n    command: \"npx\"\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-github\"]\n    env:\n      GITHUB_PERSONAL_ACCESS_TOKEN: \"ghp_xxxxxxxxxxxxxxxxxxxx\"\n\n  company_api:\n    url: \"https:\u002F\u002Fmcp.internal.company.com\u002Fmcp\"\n    headers:\n      Authorization: \"Bearer sk-xxxxxxxxxxxxxxxxxxxx\"\n    timeout: 300\n```\n\nAll tools from all servers are registered and available simultaneously. Each server's tools are prefixed with its name to avoid collisions.\n\n## Sampling (Server-Initiated LLM Requests)\n\nHermes supports MCP's `sampling\u002FcreateMessage` capability — MCP servers can request LLM completions through the agent during tool execution. This enables agent-in-the-loop workflows (data analysis, content generation, decision-making).\n\nSampling is **enabled by default**. Configure per server:\n\n```yaml\nmcp_servers:\n  my_server:\n    command: \"npx\"\n    args: [\"-y\", \"my-mcp-server\"]\n    sampling:\n      enabled: true           # default: true\n\n      max_tokens_cap: 4096    # max tokens per request\n      timeout: 30             # LLM call timeout (seconds)\n      max_rpm: 10             # max requests per minute\n      allowed_models: []      # model whitelist (empty = all)\n      max_tool_rounds: 5      # tool loop limit (0 = disable)\n      log_level: \"info\"       # audit verbosity\n```\n\nServers can also include `tools` in sampling requests for multi-turn tool-augmented workflows. The `max_tool_rounds` config prevents infinite tool loops. Per-server audit metrics (requests, errors, tokens, tool use count) are tracked via `get_mcp_status()`.\n\nDisable sampling for untrusted servers with `sampling: { enabled: false }`.\n\n## Notes\n\n- MCP tools are called synchronously from the agent's perspective but run asynchronously on a dedicated background event loop\n- Tool results are returned as JSON with either `{\"result\": \"...\"}` or `{\"error\": \"...\"}`\n- The native MCP client is independent of `mcporter` -- you can use both simultaneously\n- Server connections are persistent and shared across all conversations in the same agent process\n- Adding or removing servers requires restarting the agent (no hot-reload currently)\n\n## ? Связи\n\n- [[000 - Map of Maps]] — REPO_DOCS\n- [[000 - Map of Maps]] — Map of Maps\n\n",{"name":5,"author":49,"license":15,"version":50,"metadata":51,"description":7},"Hermes Agent","1.0.0",{"hermes":52},{"tags":53,"related_skills":55},[26,37,54],"Integrations",[56],"mcporter","main","bdd9f958d7bb1a0f19b8ad8da020b0bab0f53eb1","vc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002FREPO_DOCS\u002F02-hermes-agent\u002Fskills\u002Fmcp\u002Fnative-mcp",1,"https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis","2026-06-24 16:31:18",{"source":8,"skillName":5,"commands":65,"prompt":75,"zipAvailable":76},[66,69,72],{"tool":67,"command":68},"npx","npx skills add ibragimov-oasis\u002Fvibe-coder --skill native-mcp",{"tool":70,"command":71},"bunx","bunx skills add ibragimov-oasis\u002Fvibe-coder --skill native-mcp",{"tool":73,"command":74},"pnpm","pnpm dlx skills add ibragimov-oasis\u002Fvibe-coder --skill native-mcp","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002FREPO_DOCS\u002F02-hermes-agent\u002Fskills\u002Fmcp\u002Fnative-mcp\u002FSKILL.md",true,[],[79,114,139,159,185,216],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":93,"publishedAt":44},"01M6Q4Q22KKKVMJJYA411DQ4ER","ckm:ui-styling","Create beautiful, accessible user interfaces with shadcn\u002Fui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fui-design\u002Fui-rules\u002Fui-ux-pro-max\u002Fclaude\u002Fskills\u002Fui-styling\u002FSKILL.md",[85,88],{"categoryNo":86,"categoryName":87,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":89,"categoryName":90,"taxonomyType":91,"taxonomyTypeDesc":92},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113],"ui styling","ui","styling","ckm:ui styling","ckm","design","css","canvas","components","component","create","design systems","Tailwind","across","themes","utility","mode","implementing","artifact\u002Fui-component","source\u002Fui-design",{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":126,"publishedAt":44},"01M6Q4PQ2NX4NDVWTEHA3MQ2R0","ckm:design","Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social\u002Fads\u002Fweb\u002Fprint), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fui-design\u002Fui-rules\u002Fui-ux-pro-max\u002Fclaude\u002Fskills\u002Fdesign\u002FSKILL.md",[120,123,124,125],{"categoryNo":121,"categoryName":122,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000003","演示文稿",{"categoryNo":86,"categoryName":87,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":89,"categoryName":90,"taxonomyType":91,"taxonomyTypeDesc":92},[99,116,98,127,103,94,128,104,129,130,131,132,133,134,135,136,137,138,112,113],"google","presentations","generate","screenshot","actions","Media","logo","ads","youtube","tiktok","artifact","chart",{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":147,"publishedAt":44},"01M6Q4PJE27GEA3M0CECEBCZKS","ckm:design-system","Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component), CSS variables, spacing\u002Ftypography scales, component specs, strategic slide creation. Use for design tokens, systematic design, brand-compliant presentations.","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fui-design\u002Fui-rules\u002Fui-ux-pro-max\u002Fclaude\u002Fskills\u002Fdesign-system\u002FSKILL.md",[145,146],{"categoryNo":86,"categoryName":87,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":89,"categoryName":90,"taxonomyType":91,"taxonomyTypeDesc":92},[99,148,149,150,116,98,100,103,151,128,137,152,153,154,155,156,157,158,112,113],"design system","system","ckm:design system","architecture","token","creation","systematic","css variables","Variables","spacing","layer",{"skillNo":160,"name":161,"nameZh":6,"description":162,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":163,"categories":164,"keywords":170,"publishedAt":44},"01M6Q4P90JXFYMH2S634QM6SQJ","ckm:banner-design","Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter\u002FX, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fui-design\u002Fui-rules\u002Fui-ux-pro-max\u002Fclaude\u002Fskills\u002Fbanner-design\u002FSKILL.md",[165,168,169],{"categoryNo":166,"categoryName":167,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":86,"categoryName":87,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":89,"categoryName":90,"taxonomyType":91,"taxonomyTypeDesc":92},[99,171,172,173,98,174,131,132,175,176,177,178,179,180,181,182,112,113,183,184],"banner design","ckm:banner design","banner","frontend","3D","generated","Art","social","dimensions","neon","direction","display","frontend-design","hero",{"skillNo":186,"name":187,"nameZh":6,"description":188,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":189,"categories":190,"keywords":197,"publishedAt":44},"01M6Q2RZXBJ9TBE413GXCYQNDB","seo","Comprehensive SEO analysis for any website or business type. Performs full site audits, single-page deep analysis, technical SEO checks (crawlability, indexability, Core Web Vitals with INP), schema markup detection\u002Fvalidation\u002Fgeneration, content quality assessment (E-E-A-T framework per Dec 2025 update extending to all competitive queries), image optimization, sitemap analysis, and Generative Engine Optimization (GEO) for AI Overviews, ChatGPT, and Perplexity citations. Analyzes AI crawler accessibility (GPTBot, ClaudeBot, PerplexityBot), llms.txt compliance, brand mention signals, and passage-level citability. Industry detection for SaaS, e-commerce, local business, publishers, agencies. Triggers on: \"SEO\", \"audit\", \"schema\", \"Core Web Vitals\", \"sitemap\", \"E-E-A-T\", \"AI Overviews\", \"GEO\", \"technical SEO\", \"content quality\", \"page speed\", \"structured data\".","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fskills\u002Fskills-seo\u002Fseo\u002Fclaude-seo\u002Fskills\u002Fseo\u002FSKILL.md",[191,194],{"categoryNo":192,"categoryName":193,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000019","营销推广",{"categoryNo":195,"categoryName":196,"taxonomyType":91,"taxonomyTypeDesc":92},"01JBSEEDCAT000000000000035","市场营销",[187,198,199,200,201,202,203,137,204,205,206,207,208,209,210,211,212,213,214,215],"image","llms","assessment","deep analysis","Citations","analysis","local","deep","crawlability","seo analysis","2025","commerce","URL","domain\u002Fseo","source\u002Fskills-seo","vitals","generative","publishers",{"skillNo":217,"name":218,"nameZh":6,"description":219,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":220,"categories":221,"keywords":224,"publishedAt":44},"01M6Q2RVE7VGFCFQKBK468NHVY","seo-technical","Technical SEO audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JavaScript rendering, and IndexNow protocol. Use when user says \"technical SEO\", \"crawl issues\", \"robots.txt\", \"Core Web Vitals\", \"site speed\", or \"security headers\".","https:\u002F\u002Fgithub.com\u002Fibragimov-oasis\u002Fvibe-coder\u002Fblob\u002Fmain\u002Fvc-kit\u002Fcontent\u002FCOMBINED\u002FCOMBINED\u002Fskills\u002Fskills-seo\u002Fseo\u002Fclaude-seo\u002Fskills\u002Fseo-technical\u002FSKILL.md",[222,223],{"categoryNo":192,"categoryName":193,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":195,"categoryName":196,"taxonomyType":91,"taxonomyTypeDesc":92},[187,225,226,227,228,229,230,231,232,137,107,206,233,234,210,235,236,211,212,213],"technical","seo technical","issues","audit","data","mobile","crawl","structure","rendering","technical seo audit","headers","categories"]