Skip to main content

​
Prerequisites

Check your version: node --versionDownload from nodejs.org if needed.
You need three values:
  • GIZA_API_KEY — your partner API key
  • GIZA_API_URL — Giza backend URL
  • GIZA_PARTNER_NAME — your partner identifier

Get API Keys

Contact Giza to obtain your credentials

​
Claude Desktop

Add the following to your Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "giza": {
      "command": "npx",
      "args": ["@gizatech/mcp-server"],
      "env": {
        "GIZA_API_KEY": "your-api-key",
        "GIZA_PARTNER_NAME": "your-partner-name",
        "GIZA_API_URL": "https://api.giza.tech",
        "CHAIN_ID": "8453"
      }
    }
  }
}
Restart Claude Desktop. You should see the Giza tools available in the tools menu (hammer icon).
CHAIN_ID defaults to Base (8453). Change it to target a different chain.

​
Cursor

Add the same configuration to your Cursor MCP settings:
  1. Open Cursor Settings
  2. Navigate to Features > MCP Servers
  3. Click Add new MCP Server
  4. Select Command as the type and configure:
{
  "mcpServers": {
    "giza": {
      "command": "npx",
      "args": ["@gizatech/mcp-server"],
      "env": {
        "GIZA_API_KEY": "your-api-key",
        "GIZA_PARTNER_NAME": "your-partner-name",
        "GIZA_API_URL": "https://api.giza.tech",
        "CHAIN_ID": "8453"
      }
    }
  }
}

​
Claude Code

Add the MCP server to your Claude Code project configuration: 
claude mcp add giza -- npx @gizatech/mcp-server
Set the required environment variables in your shell before launching Claude Code, or use the --env flag: 
claude mcp add giza \
  --env GIZA_API_KEY=your-api-key \
  --env GIZA_PARTNER_NAME=your-partner-name \
  --env GIZA_API_URL=https://api.giza.tech \
  --env CHAIN_ID=8453 \
  -- npx @gizatech/mcp-server

​
CLI (Direct)

Run the server directly from the command line: 
export GIZA_API_KEY=your-api-key
export GIZA_PARTNER_NAME=your-partner-name
export GIZA_API_URL=https://api.giza.tech
export CHAIN_ID=8453

npx @gizatech/mcp-server
This starts the server with stdio transport. Pipe it into any MCP client that supports stdin/stdout communication. To start with HTTP transport instead: 
export TRANSPORT=http
export PORT=3000

npx @gizatech/mcp-server
The server listens on http://localhost:3000/mcp with a health check at /health.

​
Verify It Works

Once connected, ask the LLM to list available tokens: 
You: "What tokens are available on Base?"
The LLM should call get_tokens and return a list of supported tokens with their addresses, symbols, and current prices. Try a full flow: 
You: "Create a smart account for 0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
You: "What protocols support USDC?"
You: "Show me my portfolio"

​
Environment Variables

VariableRequiredDefaultDescription
GIZA_API_KEYYes—Partner API key
GIZA_PARTNER_NAMEYes—Partner identifier
GIZA_API_URLYes—Giza backend URL
CHAIN_IDNo—Chain ID (e.g., 8453 for Base)
TRANSPORTNostdioTransport type: stdio or http
PORTNo3000HTTP port (only used when TRANSPORT=http)

​
Next Steps

Tools Reference

See all 22 tools and their parameters

Configuration

Customize the server with three configuration tiers