Nucleus MCP stdio Wrapper

Claude Desktop integration for Nucleus MCP Gateway.

Installation

No installation required! Use with npx:

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "nucleus": {
      "command": "npx",
      "args": ["-y", "nucleus-mcp-stdio"],
      "env": {
        "NUCLEUS_API_KEY": "nuc_prod_your_key_here",
        "NUCLEUS_URL": "https://nucleus.biotrust.com"
      }
    }
  }
}

macOS / Linux

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nucleus": {
      "command": "npx",
      "args": ["-y", "nucleus-mcp-stdio"],
      "env": {
        "NUCLEUS_API_KEY": "nuc_prod_your_key_here",
        "NUCLEUS_URL": "https://nucleus.biotrust.com"
      }
    }
  }
}

Getting Your API Key

1. Login to https://nucleus.biotrust.com
2. Go to Settings (gear icon)
3. Scroll to "API Keys" section
4. Click "Create API Key"
5. Give it a name like "My Claude Desktop"
6. Copy the key (starts with nuc_prod_...)
7. Paste into the config above

Available Tools

All Nucleus MCP servers are accessible:

• Ada (🤖) - Chatbot metrics, conversations, knowledge base
• Shopify (🛍️) - Products, orders, customers, inventory
• Amazon Ads (📊) - Campaigns, budgets, performance metrics
• Klaviyo (📧) - Email marketing, profiles, campaigns, flows
• Seller Central (📦) - Amazon orders, inventory, sales metrics
• Nucleus (⚛️) - Job history, schedules, system health

Access depends on your Nucleus role/permissions.

Usage

After configuration, restart Claude Desktop. You should see:

🔌 MCP: nucleus

Then you can ask Claude things like:

• "How many Amazon orders yesterday?"
• "What's our CSAT score this week?"
• "Show me Shopify orders from last month"
• "What campaigns are running in Amazon Ads?"

Troubleshooting

"Skipped invalid MCP server config"

• Check JSON syntax (no trailing commas!)
• Verify NUCLEUS_API_KEY is set correctly

"Invalid or expired token"

• Regenerate API key in Nucleus Settings
• Make sure key starts with nuc_prod_

Tools not appearing

• Verify you have MCP_CHAT_ACCESS permission in Nucleus
• Check CloudWatch logs at https://nucleus.biotrust.com

Development

To build locally:

cd app/cli/nucleus-mcp-stdio
npm install
npm run build

Test locally:

NUCLEUS_API_KEY=nuc_prod_xxx NUCLEUS_URL=https://nucleus.biotrust.com node dist/index.js

License

Proprietary - BioTRUST Nutrition