# Connect Continue.dev to Axiom

**Transport:** stdio (Continue also supports HTTP/SSE)
**Auth:** local-stdio (Phase 0)
**Status:** Untested — recipe inferred from upstream docs

Continue.dev is the open-source AI coding assistant for VS Code and
JetBrains. MCP support is wired through `~/.continue/config.yaml`
(global) or `.continue/config.yaml` at the project root.

## Install prerequisites

- Continue VS Code or JetBrains extension (latest; MCP support landed
  in 0.9.x+).
- Same Axiom prerequisites as the other recipes.

## Configure the connection

Append an `mcpServers` block to `~/.continue/config.yaml`:

```yaml
mcpServers:
  - name: axiom-root
    command: /absolute/path/to/.venv/bin/axi
    args:
      - mcp
      - serve
```

Worktree variant:

```yaml
mcpServers:
  - name: axiom-root
    command: /absolute/path/to/.venv/bin/python3
    args:
      - -m
      - axiom.extensions.builtins.mcp.server
    env:
      PYTHONPATH: /absolute/path/to/axiom-checkout/src
```

## Verify

Reload the Continue extension (`Cmd-Shift-P -> Continue: Reload Config`).
In the chat panel, click the tools indicator — `axiom-root` should
appear with its tool list. Ask:

```
Use axiom_node__hooks_list with no arguments and show me the JSON.
```

Expected:

```json
{
  "node": "/Users/<you>/.axiom",
  "hooks_total": 0,
  "events_observed": [],
  "by_event": {}
}
```

## Notes

- Continue scopes tools per "assistant" role. To make Axiom's tools
  available in agent mode, ensure your assistant config doesn't
  filter MCP tools out (Continue defaults to "all available" for
  user-defined assistants).
- Project-local `.continue/config.yaml` overrides the global file; if
  you want the connection only on one project, use that path.
- HTTP/SSE support exists upstream; needs Axiom Phase 5 auth.

## Troubleshooting

| Symptom | Likely cause | Fix |
|---|---|---|
| `mcpServers` ignored | YAML indentation error | Validate via `continue config validate` |
| Tools missing | assistant filter | Edit assistant block, add `tools: ["*"]` |
| Stale surface | Continue caches per session | Reload the Continue extension |

## References

- ADR-038 §D7
- Continue MCP docs: https://docs.continue.dev/customize/deep-dives/mcp

_Copyright (c) 2026 B-Tree Ventures, LLC. Apache-2.0 licensed._
