@mammoth-protocol/mcp-server

MCP (Model Context Protocol) server for Mammoth Protocol.

Makes Mammoth a native tool for any LLM agent — Claude, GPT, Gemini, Eliza, Virtuals, ai16z, and any other MCP-compatible system. No custom integration per agent. One server, all of them.

Quick Start

npx @mammoth-protocol/mcp-server

Read-only by default (discovery, quotes, snapshots). Add a wallet for buy execution:

MAMMOTH_WALLET_KEY='[your-keypair-json-array]' npx @mammoth-protocol/mcp-server

Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mammoth": {
      "command": "npx",
      "args": ["@mammoth-protocol/mcp-server"],
      "env": {
        "SOLANA_CLUSTER": "devnet"
      }
    }
  }
}

With buy execution:

{
  "mcpServers": {
    "mammoth": {
      "command": "npx",
      "args": ["@mammoth-protocol/mcp-server"],
      "env": {
        "SOLANA_CLUSTER": "mainnet-beta",
        "SOLANA_RPC_URL": "https://your-rpc-endpoint.com",
        "MAMMOTH_WALLET_KEY": "[your,keypair,as,json,array]"
      }
    }
  }
}

Connect to Cursor / Windsurf / Cline

Add to your MCP config file (.cursor/mcp.json or equivalent):

{
  "mcpServers": {
    "mammoth": {
      "command": "npx",
      "args": ["@mammoth-protocol/mcp-server"]
    }
  }
}

Connect to a Custom Agent (Eliza, Virtuals, ai16z)

const { Client } = require('@modelcontextprotocol/sdk/client/index.js');
const { StdioClientTransport } = require('@modelcontextprotocol/sdk/client/stdio.js');

const transport = new StdioClientTransport({
  command: 'npx',
  args: ['@mammoth-protocol/mcp-server'],
  env: { SOLANA_CLUSTER: 'devnet' },
});

const client = new Client({ name: 'my-agent', version: '1.0.0' });
await client.connect(transport);

// List all open cycles
const result = await client.callTool({ name: 'mammoth_get_open_cycles', arguments: {} });
console.log(result.content[0].text);

// Get snapshot for a specific project
const snap = await client.callTool({
  name: 'mammoth_get_cycle_snapshot',
  arguments: { mintAddress: 'YOUR_MINT_ADDRESS' }
});

// Get a buy quote
const quote = await client.callTool({
  name: 'mammoth_buy_quote',
  arguments: { mintAddress: 'YOUR_MINT_ADDRESS', solAmount: 0.5 }
});

Available Tools

| Tool | Description | |---|---| | mammoth_get_open_cycles | All active cycles with price, fill %, and curve type | | mammoth_get_cycle_snapshot | Full decision snapshot for a specific mint | | mammoth_get_projects | All Mammoth projects with supply mode and cycle count | | mammoth_get_rights_window_cycles | Cycles where rights window is currently open | | mammoth_check_rights | Check if a wallet has unexercised rights | | mammoth_buy_quote | Calculate tokens out for SOL in — no transaction | | mammoth_buy_tokens | Execute a buy (requires MAMMOTH_WALLET_KEY) | | mammoth_protocol_reference | Full protocol mechanics and parameter reference |

Available Resources

| URI | Description | |---|---| | mammoth://protocol/reference | Protocol constants and parameter definitions |

Environment Variables

| Variable | Default | Description | |---|---|---| | SOLANA_RPC_URL | Devnet public RPC | RPC endpoint (use a private endpoint for production) | | SOLANA_CLUSTER | devnet | devnet or mainnet-beta | | MAMMOTH_WALLET_KEY | none | Keypair as JSON array or base58 string. Required for buy execution. |

Why Mammoth for AI Agents

Mammoth Protocol is designed for autonomous participation:

• Bounded curves — deterministic pricing. A bot calculates exact cost before submitting. No AMM slippage surprises.
• Cycle events — agents only need to act at defined moments (cycle open, rights window, close). No constant monitoring required.
• Rights system — a bot holding from Cycle 1 gets guaranteed first access to Cycle 2 at base price. Structurally advantaged position.
• AuthorityConfig — a principal (human or AI) can delegate specific operations to an operator bot with explicit permissions and spending limits.

No other launchpad was built for this.

For Portfolio AI Agents

If you're building an AI that manages a user's high-growth crypto allocation:

1. Call mammoth_get_open_cycles to discover available cycles
2. Call mammoth_get_cycle_snapshot on interesting projects
3. Call mammoth_buy_quote to calculate exact outcome
4. Present to user or execute autonomously (if authorized)
5. Subscribe to CycleOpened events via the SDK for zero-latency triggers

The whole flow is programmatic. No UI. No human clicking buttons.

SDK

For direct programmatic access (without MCP):

npm install @mammoth-protocol/sdk

SDK docs →

Links

• Protocol: https://mammoth-protocol.vercel.app
• AI Reference: https://mammoth-protocol.vercel.app/ai-reference
• Protocol Reference: https://mammoth-protocol.vercel.app/protocol
• SDK: https://github.com/kelvinsinferno/mammoth-sdk

MIT — Kelvinsinferno Studio