MCP setup

Setup

1. Install uv

   macOS (Homebrew)

   brew install uv

   macOS / Linux

   curl -LsSf https://astral.sh/uv/install.sh | sh

   Windows

   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

   Run which uvx and note the full path (for example /opt/homebrew/bin/uvx). You’ll need it below.

2. Get your API key

   Request an API key from ZettaQuant, then test it:

   curl -H "x-api-key: YOUR_KEY" https://api.zettaquant.ai/v1/usage/me

3. Add the server to your host

   Replace YOUR_KEY and the uvx path with your values.

   Cursor

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "zettaquant-vslm": {
         "command": "/opt/homebrew/bin/uvx",
         "args": ["zettaquant-vslm-mcp"],
         "env": { "ZQ_API_KEY": "YOUR_KEY" }
       }
     }
   }

   Claude Desktop

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

   claude_desktop_config.json

   {
     "mcpServers": {
       "zettaquant-vslm": {
         "command": "/opt/homebrew/bin/uvx",
         "args": ["zettaquant-vslm-mcp"],
         "env": { "ZQ_API_KEY": "YOUR_KEY" }
       }
     }
   }

   Claude Code

   claude mcp add zettaquant-vslm --env ZQ_API_KEY=YOUR_KEY -- /opt/homebrew/bin/uvx zettaquant-vslm-mcp

   Zed

   ~/.config/zed/settings.json

   {
     "context_servers": {
       "zettaquant-vslm": {
         "command": {
           "path": "/opt/homebrew/bin/uvx",
           "args": ["zettaquant-vslm-mcp"],
           "env": { "ZQ_API_KEY": "YOUR_KEY" }
         }
       }
     }
   }

4. Restart the host

Test

Paste this into your host’s chat:

Filter these sentences for rate cut expectations:
- FOMC signaled openness to rate cuts if inflation continues to soften.
- The cafeteria menu was updated last week.
- A 25bp cut in September remains the base case for most participants.

The host should call vslm_predict and return only the two rate-cut sentences.

Troubleshooting

Symptom	Fix
Server shows red / “connection failed”	Wrong command path. Use the output of which uvx.
Crashes on startup / No module named 'mcp.server.fastmcp'	Stale cached build. Refresh with uvx --refresh zettaquant-vslm-mcp (needs 0.1.1 or later).
ZettaQuant auth failed (401)	Wrong or expired key. Retest with the curl in step 2.
ZettaQuant plan not active (402)	Your ZettaQuant plan is inactive. Contact support@zettaquant.ai.
ZettaQuant access denied (403)	Your key lacks the vslm scope. Contact support@zettaquant.ai.
ZettaQuant quota exceeded (429)	You hit your per-period cap. The reset time is in the error message.

Links

• PyPI
• GitHub
• Glama