Configure Skill Vault in 3 steps

Skill Vault supports local stdio and remote streamable-http MCP setups. Choose your transport, then paste the client snippet for Claude Code, Cursor, Codex, or Gemini CLI.

Step 0 — Get an API key

Create an agent key from /dashboard/onboard. The raw key is shown once during onboarding.

Where's my key? Use the onboarding screen in the dashboard. Pass the key as the agent_key tool argument on private/global tool calls. Skill Vault does not use a connection-level auth header for this key.

Step 1 — Run the server

skill-vault serve

skill-vault serve --transport streamable-http --host 0.0.0.0 --port 8000

Remote MCP URL pattern: http://<host>:8000/mcp

Remote endpoint: http://<your-host-or-ip>:8000/mcp

Replace <your-host-or-ip> with your externally reachable host.

Step 2 — Configure your client

Every snippet includes an agent_key note. Paste your key from dashboard onboarding and pass it as the agent_key tool argument.

Claude Code — stdio

claude mcp add skill-vault -- skill-vault serve
# agent_key: paste your SKILL_VAULT_AGENT_KEY from the dashboard onboarding screen (passed as the agent_key tool argument)

Claude Code — streamable-http

claude mcp add skill-vault --transport http http://<your-host-or-ip>:8000/mcp
# agent_key: paste your SKILL_VAULT_AGENT_KEY from the dashboard onboarding screen (passed as the agent_key tool argument)

Cursor — stdio (.cursor/mcp.json)

{
  "mcpServers": {
    "skill-vault": {
      "command": "skill-vault",
      "args": ["serve"]
    }
  }
}
# agent_key: paste your SKILL_VAULT_AGENT_KEY from the dashboard onboarding screen (passed as the agent_key tool argument)

Cursor — streamable-http (.cursor/mcp.json)

{
  "mcpServers": {
    "skill-vault": {
      "url": "http://<your-host-or-ip>:8000/mcp"
    }
  }
}
# agent_key: paste your SKILL_VAULT_AGENT_KEY from the dashboard onboarding screen (passed as the agent_key tool argument)

Codex — stdio (~/.codex/config.toml)

[mcp_servers.skill-vault]
command = "skill-vault"
args = ["serve"]
# agent_key: paste your SKILL_VAULT_AGENT_KEY from the dashboard onboarding screen (passed as the agent_key tool argument)

Codex — streamable-http (~/.codex/config.toml)

[mcp_servers.skill-vault]
transport = "http"
url = "http://<your-host-or-ip>:8000/mcp"
# agent_key: paste your SKILL_VAULT_AGENT_KEY from the dashboard onboarding screen (passed as the agent_key tool argument)

Gemini CLI — stdio

gemini mcp add skill-vault -- skill-vault serve
# agent_key: paste your SKILL_VAULT_AGENT_KEY from the dashboard onboarding screen (passed as the agent_key tool argument)

Gemini CLI — streamable-http

gemini mcp add skill-vault --transport http http://<your-host-or-ip>:8000/mcp
# agent_key: paste your SKILL_VAULT_AGENT_KEY from the dashboard onboarding screen (passed as the agent_key tool argument)

Troubleshooting

Private skills missing? Ensure every private/global tool call includes agent_key.
Remote connection refused? Confirm host/port are reachable and server started with --transport streamable-http.
Remote endpoint path must be /mcp (not a different route).