mcpServers config shape.
Claude Desktop
1
Open the config file
Settings → Developer → Edit Config, or edit it directly:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
2
Add the XentFi server
3
Restart Claude Desktop
Fully quit and reopen the app. Open a new chat, click the tools/plug icon, and confirm
xentfi appears with its 15 tools.4
Try it
Ask: “Check my XentFi agent info and list my wallets.”
Global install alternative
If you’d rather not havenpx re-resolve the package every launch:
Claude Code
XENTFI_AGENT_KEY as an environment variable in the shell Claude Code runs in, or add it to the generated config entry’s "env" block the same way as above. Verify with:
xentfi listed as connected.
Troubleshooting
Server doesn't appear
Server doesn't appear
Check Claude Desktop’s MCP logs (Settings → Developer → Open Logs Folder) for
[xentfi-mcp] startup lines or a Missing XENTFI_AGENT_KEY error."Missing XentFi agent API key" tool errors
"Missing XentFi agent API key" tool errors
The env var didn’t reach the subprocess — check the
env block is inside the xentfi server entry, not at the top level of the config file.npx is slow on every launch
npx is slow on every launch
Switch to the global-install form above, or pin a version:
"args": ["-y", "@xentfi/mcp-server@1.0.0"].Next steps
Tools Reference
See every available tool.
Other clients
Cursor, VS Code, ChatGPT, ElizaOS, CrewAI, Codex.