nerve-mcp

---\nname: nerve-mcp\ndescription: "Connect to the Nerve MCP server (37 tools, 3 transports: SSE/stdio/HTTP). Covers routing, cache, compression, memory, skills, providers, and audit tools across 16 permission scopes."\n---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

Connect to the Nerve MCP server (37 tools, 3 transports: SSE/stdio/HTTP). Covers routing, cache, compression, memory, skills, providers, and audit tools across 16 permission scopes.

## Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development.

## Endpoints

_No endpoints mapped for this area yet._
## Payloads

See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.

<!-- skill:custom-start -->
<!-- Migrated from skills/nerve-mcp/SKILL.md (preserved curated content) -->

# Nerve — MCP Server

Requires `NERVE_URL` and `NERVE_KEY`. See [entry-point SKILL](https://raw.githubusercontent.com/diegosouzapw/Nerve/main/skills/nerve/SKILL.md) for setup.

## Transports

- **stdio** — local IPC, for Claude Desktop / VS Code extensions
- **SSE** — `GET $NERVE_URL/api/mcp/sse`
- **Streamable HTTP** — `POST $NERVE_URL/api/mcp/stream`

## Claude Desktop config

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "nerve": {
      "command": "npx",
      "args": ["-y", "nerve", "--mcp"],
      "env": { "NERVE_KEY": "sk-..." }
    }
  }
}
```

## Cursor / VS Code config

```json
{
  "mcp": {
    "servers": {
      "nerve": {
        "url": "http://localhost:20128/api/mcp/sse",
        "headers": { "Authorization": "Bearer sk-..." }
      }
    }
  }
}
```

## Available tools (37 total)

| Scope     | Tools                                                                                              |
| --------- | -------------------------------------------------------------------------------------------------- |
| health    | `nerve_get_health`                                                                             |
| combos    | `nerve_list_combos`, `nerve_get_combo_metrics`, `nerve_switch_combo`                   |
| routing   | `nerve_simulate_route`, `nerve_best_combo_for_task`, `nerve_explain_route`             |
| providers | `nerve_get_provider_metrics`, `nerve_check_quota`, `nerve_route_request`               |
| budget    | `nerve_set_budget_guard`, `nerve_set_routing_strategy`, `nerve_set_resilience_profile` |
| testing   | `nerve_test_combo`                                                                             |
| memory    | `memory_add`, `memory_search`, `memory_delete`                                                     |
| skills    | `skill_invoke`, `skill_list`, `skill_describe`, `skill_register`                                   |
| cache     | `nerve_cache_stats`, `nerve_cache_flush`                                                   |
| admin     | `nerve_db_health_check`, `nerve_sync_pricing`, `nerve_get_session_snapshot`            |

Full list: `GET $NERVE_URL/api/mcp/tools`

## Scopes

Tools are grouped into 13 scopes (chat-only, memory-readonly, full-admin, etc.).
Pass scope name as `--scope` arg or via `X-Nerve-Scope` header.

## Reference

Full docs: https://github.com/diegosouzapw/Nerve/blob/main/docs/frameworks/MCP-SERVER.md
<!-- skill:custom-end -->