Windsurf Animica animica_embed

How to: Windsurf Animica animica_embed

client:Windsurf transport:streamable-http tool:animica_embed

Add Animica to Windsurf

01
Open ~/.codeium/windsurf/mcp_config.json and merge this in. Keep any servers already there.

{
  "mcpServers": {
    "animica": {
      "serverUrl": "https://mcp.animica.org/mcp"
    }
  }
}

02
Save the file and restart Windsurf.
03
Ask for something animica_embed does. Windsurf lists the server's tools on connect and calls animica_embed itself — you do not invoke it by name.
04
If nothing happens, check the server is running and that Animica's identifier in your config matches the one above exactly.

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

Set these first

Animica will not start until these are set, so animica_embed never becomes available.

ANIMICA_API_KEY
ANIMICA_RPC_URL
ANIMICA_BASE_URL
ANIMICA_POOL_URL
ANIMICA_BEACON_URL
ANIMICA_MODEL
ANIMICA_MCP_TIMEOUT_S

Same tool, other clients

This list was read from the server itself, by connecting to it and calling tools/list on 24 September 2026. It is what the server actually exposes, not what its listing claims.

Mutating and Read-only are read off each tool's name, not its schema — a hint, not a guarantee. The registry stores tool names only; connect the server for its live schemas.

Animica MCP server