MCP 服务器

Mammoth MCP Server

Enables LLM agents to interact with the Mammoth Protocol on Solana for discovering cycles, getting quotes, and executing buys via bounded-curve mechanics.

README

@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.