Limitless MCP

Limitless MCP Server

⚠️ Aviso: Quantish está cerrando. La plataforma Quantish (quantish.live) está cerrando. Este servidor MCP es autoalojado y seguirá funcionando de forma independiente, pero el equipo de Quantish ya no mantendrá ni actualizará este proyecto. Si estás construyendo en el espacio de mercados de predicción y necesitas infraestructura de datos en tiempo real, consulta polynode.dev.

Características

• Gestión Segura de Wallets

  • Genera nuevas wallets de Base con almacenamiento cifrado de claves privadas
  • Trae Tu Propia Wallet (BYOW) - Importa wallets existentes con cifrado del lado del cliente
  • Las claves privadas se cifran con AES-256-GCM antes de almacenarse

• Acceso Completo a los Mercados de Limitless

  • Descubrimiento de mercados en tiempo real vía API de Limitless Exchange
  • Acceso a todos los mercados de predicción: Política, Deportes, Cripto y más
  • Datos de orderbook en vivo e historial de precios
  • Búsqueda semántica para descubrimiento de mercados

• Operaciones de Trading

  • Coloca órdenes límite con autenticación firmada EIP-712
  • Cancela órdenes (individuales, por lote o todas)
  • Verifica y establece aprobaciones de tokens (USDC, CTF)
  • Seguimiento de posiciones con cálculos de P&L

• Integración con Agentes de IA

  • Soporte completo de MCP (Protocolo de Contexto del Modelo)
  • Funciona con Claude, Cursor IDE y otras herramientas de IA compatibles con MCP
  • 34 herramientas de trading preconstruidas organizadas por categoría

• Seguridad Empresarial

  • Cifrado AES-256-GCM para todos los datos sensibles
  • Autenticación de claves API con hash SHA-256
  • Sistema de socios de plataforma para integraciones B2B
  • Límites de tasa y registro de solicitudes

Inicio Rápido

1. Configura MCP (Cursor IDE)

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "limitless": {
      "url": "https://limitless-mcp-server-production.up.railway.app/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

2. Obtén Tu Clave API

Vía herramienta MCP:

{
  "tool": "limitless_signup",
  "args": {
    "externalId": "your-unique-id"
  }
}

3. Comienza a Operar

"Search for bitcoin prediction markets"
"Buy 10 YES shares at $0.60 on the BTC market"
"Show my current positions"
"Cancel my open orders"

Herramientas MCP Disponibles (34 en Total)

Nota: Todos los nombres de herramientas llevan el prefijo limitless_ para evitar colisiones con otros MCP.

Autenticación y Configuración (6 herramientas)

Información de Wallet (4 herramientas)

Descubrimiento de Mercados (6 herramientas)

Trading (8 herramientas)

Posiciones (4 herramientas)

Transferencias (3 herramientas)

Gestión de Claves API (3 herramientas)

Autoalojamiento

Requisitos previos

• Node.js 20+
• PostgreSQL 15+
• Acceso RPC de Base (mainnet.base.org)

Instalación

# Clone the repository
git clone https://github.com/joinQuantish/limitless-mcp.git
cd limitless-mcp

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Edit .env with your values (see Environment Variables below)

# Generate Prisma client
npx prisma generate

# Push database schema
npx prisma db push

# Build and start
npm run build
npm start

Variables de Entorno

Crea un archivo .env con:

# Database (PostgreSQL)
DATABASE_URL="postgresql://user:password@host:5432/limitless_mcp?schema=public"

# Encryption (generate with: openssl rand -hex 32)
ENCRYPTION_KEY="your-64-character-hex-encryption-key-here"

# Blockchain - Base L2
BASE_RPC_URL="https://mainnet.base.org"

# Limitless Exchange API
LIMITLESS_API_URL="https://api.limitless.exchange"

# Server
PORT=3003
NODE_ENV=production

# Admin API Key (generate with: openssl rand -hex 32)
ADMIN_API_KEY="your-admin-api-key-here"

# Optional: Bot signing secret for returning user verification
BOT_SIGNING_SECRET=""

Despliegue con Docker

# Build the image
docker build -t limitless-mcp .

# Run the container
docker run -d \
  -p 3003:3003 \
  -e DATABASE_URL="postgresql://..." \
  -e ENCRYPTION_KEY="..." \
  -e ADMIN_API_KEY="..." \
  -e BASE_RPC_URL="https://mainnet.base.org" \
  -e LIMITLESS_API_URL="https://api.limitless.exchange" \
  -e NODE_ENV=production \
  limitless-mcp

Despliegue en Railway

# Install Railway CLI
npm install -g @railway/cli

# Login and initialize
railway login
railway init

# Add PostgreSQL via Railway dashboard

# Set environment variables
railway variables set DATABASE_URL="postgresql://..."
railway variables set ENCRYPTION_KEY="$(openssl rand -hex 32)"
railway variables set ADMIN_API_KEY="$(openssl rand -hex 32)"
railway variables set BASE_RPC_URL="https://mainnet.base.org"
railway variables set LIMITLESS_API_URL="https://api.limitless.exchange"
railway variables set NODE_ENV="production"

# Deploy
railway up

Referencia de API

Verificación de Salud

curl https://your-server/health

Respuesta:

{
  "status": "healthy",
  "timestamp": "2026-01-17T12:00:00.000Z",
  "version": "1.0.0",
  "service": "limitless-mcp",
  "database": "connected",
  "environment": "production"
}

Endpoint MCP

# List available tools
curl -X POST https://your-server/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Call a tool (authenticated)
curl -X POST https://your-server/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_limitless_..." \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/call",
    "params":{
      "name":"limitless_get_balances",
      "arguments":{}
    }
  }'

API de Datos de Mercado

# Get active markets
curl "https://your-server/api/markets?limit=10&page=1"

# Search markets
curl "https://your-server/api/markets/search?query=bitcoin&limit=5"

# Get market details
curl "https://your-server/api/markets/your-market-slug"

# Get orderbook
curl "https://your-server/api/markets/your-market-slug/orderbook"

Arquitectura de Seguridad

API Key Format: pk_limitless_<32 base64url chars>
API Secret Format: sk_limitless_<43 base64url chars>

Importación Segura de Wallet (BYOW)

Importa tu wallet existente de MetaMask/hardware de forma segura:

Paso 1: Exporta Tu Clave Privada

En MetaMask: Configuración > Seguridad > Exportar Clave Privada

Paso 2: Cifra Localmente

const crypto = require('crypto');

const privateKey = 'YOUR_PRIVATE_KEY_WITHOUT_0x_PREFIX';
const password = 'YourSecurePassword123!'; // min 12 chars

const salt = crypto.randomBytes(32);
const iv = crypto.randomBytes(16);
const derivedKey = crypto.scryptSync(password, salt, 32, { N: 16384, r: 8, p: 1 });

const cipher = crypto.createCipheriv('aes-256-gcm', derivedKey, iv);
let encrypted = cipher.update(privateKey, 'utf8', 'hex');
encrypted += cipher.final('hex');
const authTag = cipher.getAuthTag().toString('hex');

console.log({
  encryptedKey: `${encrypted}:${authTag}`,
  salt: salt.toString('hex'),
  iv: iv.toString('hex'),
  publicKey: 'YOUR_WALLET_ADDRESS'
});

Paso 3: Importa al SDK

{
  "tool": "limitless_import_wallet",
  "args": {
    "encryptedKey": "...",
    "salt": "...",
    "iv": "...",
    "publicKey": "0x...",
    "password": "YourSecurePassword123!"
  }
}

Nota de Seguridad: Tu clave privada sin procesar NUNCA sale de tu máquina. Solo el paquete cifrado se envía a nuestros servidores, y no podemos descifrarlo sin tu contraseña.

Recursos Relacionados

Licencia

PolyForm Noncommercial 1.0.0 © Quantish

Soporte

• Problemas: Issues de GitHub
• Correo electrónico: hello@quantish.live