<div align="center">

Sally MCP Server

AI-Powered Metabolic Health Assistant with Blockchain-Based Payments

Connect to Sally through the Model Context Protocol (MCP) with x402 payment infrastructure

Quick Start Installation Usage API Reference Deployment

</div>

---

What is Sally MCP Server?

Sally MCP Server is a Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients to interact with Sally, an AI-powered metabolic health assistant.

Built with the x402 blockchain-based payment protocol, Sally MCP ensures secure, transparent micropayments for each AI interaction while keeping your private keys and data entirely on your local machine.

Key Features

• Metabolic Health Expertise: Chat with Sally about nutrition, metabolism, and health optimization
• x402 Payment Integration: Automatic blockchain-based micropayments for API usage
• Multi-Transport Support: Deploy locally (stdio) or hosted (HTTP/SSE via Smithery)
• Security First: Private keys never leave your device
• MCP Compatible: Works with Claude Desktop, Cursor, and any MCP-compatible client
• Type-Safe: Built with TypeScript and Zod schemas for reliability
• Production Ready: Dockerized and ready for Smithery cloud deployment

Architecture

  MCP Client         
  (Claude, Cursor)   

           
           
      
  Sally MCP Server     x402 Payment    
  (Local/Smithery)           Protocol        
      
           
           

  Sally API          
  (Metabolic Health) 

---

Quick Start

Get up and running in 5 minutes:

Prerequisites

• Node.js 18+ and pnpm installed
• An MCP-compatible client (Claude Desktop, Cursor, etc.)
• A dedicated crypto wallet with small funds for x402 transactions

1. Install via Smithery (Recommended)

The easiest way to use Sally MCP is through Smithery:

npx @smithery/cli install @sally-labs/sally-ai-mcp --client claude

2. Install Locally

# Clone and setup
git clone https://github.com/sally-labs/sally-mcp.git
cd sally-mcp
pnpm install
pnpm build

3. Configure Your MCP Client

Add to your MCP client configuration (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "sally": {
      "command": "node",
      "args": ["/path/to/sally-mcp/dist/index.js"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "TRANSPORT_MODE": "stdio"
      }
    }
  }
}

4. Test the Connection

Restart your MCP client and try:

"Use the chat-with-sally tool to ask: What are the benefits of intermittent fasting?"

---

Installation

Option A: Deploy with Smithery (Cloud Hosted)

Smithery provides managed hosting for MCP servers with automatic scaling and updates.

# Install Smithery CLI
npm install -g @smithery/cli

# Install Sally MCP
npx @smithery/cli install @sally-labs/sally-ai-mcp --client claude

Configure via Smithery dashboard:

• Private Key: Your dedicated wallet's private key (with 0x prefix)
• The server will be automatically available in your MCP clients

Option B: Local Development Setup

Step 1: Create a Dedicated Wallet

** Security Critical**: Never use your main wallet for MCP integrations.

1. Create a new wallet using MetaMask, Coinbase Wallet, or similar
2. Transfer a small amount of funds (e.g., $5-10 worth of crypto)
3. Export the private key (it should start with 0x)
4. Store it securely

Step 2: Clone and Install

# Clone repository
git clone https://github.com/sally-labs/sally-mcp.git
cd sally-mcp

# Install dependencies
pnpm install

Step 3: Configure Environment

Create a .env file:

PRIVATE_KEY=0x...
TRANSPORT_MODE=stdio

Step 4: Build and Run

# Build TypeScript
pnpm build

# Run the server
node dist/index.js

---

MCP Client Configuration

Claude Desktop

1. Open Claude Desktop Settings
2. Navigate to Developer Edit Config
3. Edit claude_desktop_config.json:

{
  "mcpServers": {
    "sally": {
      "command": "node",
      "args": ["/Users/yourname/code/sally-mcp/dist/index.js"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "TRANSPORT_MODE": "stdio"
      }
    }
  }
}

1. Restart Claude Desktop
2. The Sally tools should appear automatically

Cursor

1. Open Cursor Settings
2. Navigate to Features MCP Servers
3. Add server configuration:

{
  "sally": {
    "command": "node",
    "args": ["/path/to/sally-mcp/dist/index.js"],
    "env": {
      "PRIVATE_KEY": "0x...",
      "TRANSPORT_MODE": "stdio"
    }
  }
}

1. Restart Cursor

Other MCP Clients

Refer to your client's documentation for custom MCP server configuration. You'll need:

• Command: node
• Args: ["/path/to/sally-mcp/dist/index.js"]
• Environment Variables: PRIVATE_KEY, TRANSPORT_MODE=stdio

---

Usage

Basic Interaction

Once configured, interact with Sally naturally through your MCP client:

"Use chat-with-sally to ask: What foods help stabilize blood sugar?"

"Ask Sally about the relationship between sleep and metabolic health"

"Use Sally to create a meal plan for someone with insulin resistance"

Available Tools

chat-with-sally

Chat with Sally about metabolic health topics.

Parameters:

• message (string, required)…