MCP Server Quickstart

The Fusemomo MCP Server is a thin translation layer that exposes the Fusemomo REST API as MCP tools compatible with Claude Desktop, Cursor, and any MCP-capable client.

Prerequisites

• An account at fusemomo.com
• An API key ( fm_live_... ) from your Dashboard → API Keys → Create Key

1. Set Your API Key

Get your API key at fusemomo.com/dashboard/api-keys

How you set your API key depends on your MCP client:

• Cursor inherits your shell environment, so you can set it in your ~/.zshrc or ~/.bashrc.
• Claude Desktop uses an isolated environment, so you must explicitly provide it in the configuration file.

2. Add to Your MCP Client

Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fusemomo": {
      "command": "npx",
      "args": ["-y", "@fusemomo/fusemomo-mcp"],
      "env": {
        "FUSEMOMO_API_KEY": "fm_live_your_key_here"
      }
    }
  }
}

NOTE

Claude Desktop operates in a sandboxed environment and does not inherit variables from your shell profile. You must provide the key directly in the env block.

Cursor

In Cursor: Settings → Features → MCP → Add new MCP Server

Field	Value
Name	fusemomo
Type	command
Command	npx -y @fusemomo/fusemomo-mcp

Cursor inherits your shell environment. Add the API key to your shell profile (~/.zshrc, ~/.bashrc, etc.) and restart Cursor:

NOTE

Cursor must be launched from a terminal for shell exports to be inherited. If launched via app icon, add the key to your shell profile and restart from terminal, or set it in the env block as shown for Claude Desktop.

export FUSEMOMO_API_KEY="fm_live_your_key_here"

Global Install (Alternative)

Install globally and configure with the binary name:

npm install -g @fusemomo/fusemomo-mcp

{
  "mcpServers": {
    "fusemomo": {
      "command": "fusemomo-mcp"
    }
  }
}

NOTE

If using Claude Desktop, add the env block with your API key as shown in the Claude Desktop section above.

3. Restart Your Client

Changes to MCP config require a full client restart. After restarting, verify the Fusemomo tools appear in your agent's tool list.

Environment Variables

Variable	Required	Default	Description
FUSEMOMO_API_KEY	✅	—	Your API key (fm_live_...)
FUSEMOMO_API_URL	—	https://api.fusemomo.com	Override for self-hosted deployments
FUSEMOMO_TIMEOUT	—	30000	HTTP timeout in milliseconds
LOG_LEVEL	—	info	debug | info | warn | error

Troubleshooting

Tools not appearing in Claude Desktop: Restart Claude Desktop fully after editing the config JSON.

Authentication failed / API key missing:

1. echo $FUSEMOMO_API_KEY should print your key
2. Ensure your shell profile exports it and you've opened a new terminal (or ran source ~/.zshrc or source ~/.bashrc)
3. Add the env pass-through in the config (see above)

Recommendations return plan upgrade error:get_recommendation requires a Builder plan. Upgrade at fusemomo.com/upgrade.

→ View all available tools