Bitget MCP Server

Servidor oficial MCP de Bitget para trading de criptomonedas, datos de mercado y gestión de cartera mediante lenguaje natural.

GitHub

222

Prueba este MCPPatrocinado

Documentación

Bitget Agent Hub — Ecosistema oficial de trading con IA y datos de mercado de Bitget

El kit de herramientas oficial de código abierto que conecta Claude, Cursor, Codex, ChatGPT y cualquier agente de IA compatible con MCP a tu cuenta de Bitget y a los datos de mercado.

Inicio rápido · Ecosistema · Instalador · Herramientas de trading · Herramientas de mercado · Arquitectura · Seguridad · Preguntas frecuentes

Descripción general

Bitget Agent Hub es el kit de herramientas oficial de agentes de IA de Bitget, que cubre el trading de criptomonedas y acciones estadounidenses tokenizadas — llevando 89 operaciones de Bitget UTA v3 para trading y análisis de mercado a Claude, Cursor, Codex, ChatGPT y otros agentes de IA.

Diseñado para traders individuales, desarrolladores cuantitativos y cualquier persona que quiera operar en un exchange de criptomonedas mediante lenguaje natural.

Este repositorio es el punto de entrada central para todo el ecosistema. Consulta los repositorios de cada paquete para obtener documentación detallada.

Inicio rápido

¿Qué quieres hacer?

What do you want to do with AI?
|
+-- Let an AI Agent trade on Bitget for me
|     |
|     +-- Terminal AI (Claude Code / Codex CLI / OpenClaw)
|     |   -> install agent-cli + agent-skill
|     |
|     +-- Desktop AI (Claude Desktop / Cursor / Continue)
|         -> install agent-mcp
|
+-- Let an AI Agent monitor and analyze the market for me
|     -> install bitget-signal (no account, no API key)
|
+-- I'm a developer building my own Bitget AI tool
      -> install bitget-agent-sdk

Instala con tu IA

El árbol de casos de uso anterior te indica qué paquete necesitas. Para configurar las herramientas de terminal de una sola vez, pega esto en tu IA de terminal (Claude Code, Codex, OpenClaw):

Please run `npx @bitget-ai/bitget-agent-installer upgrade-all --target all` to set up the Bitget Agent Hub terminal tools (requires Node.js 20+), then help me verify the install.

Esto instala la CLI de bgc junto con las habilidades de trading y señales de mercado, y despliega las habilidades en Claude Code, Codex y OpenClaw. La IA de escritorio (Cursor, Claude Desktop, ChatGPT) usa bitget-agent-mcp en su lugar — consulta Herramientas de trading. Para comandos por paquete, reversión y banderas, consulta Instalador a continuación.

Ecosistema

Bitget Agent Hub consta de 5 paquetes principales, cada uno con una única responsabilidad. Este repositorio también incluye la meta-herramienta bitget-agent-installer que los instala y actualiza conjuntamente.

Herramientas de trading (se requiere clave API)

Paquete	Ideal para	Qué hace
`bitget-agent-sdk`	Desarrolladores	SDK base en TypeScript con 89 operaciones de UTA v3
`bitget-agent-cli`	IA de terminal	Herramienta de línea de comandos `bgc` para Claude Code, Codex, OpenClaw
`bitget-agent-mcp`	IA de escritorio	Servidor MCP para Claude Desktop, Cursor, Windsurf, ChatGPT
`bitget-agent-skill`	IA de terminal	Guía de razonamiento de IA que enseña a usar `bgc` correctamente

Herramientas de mercado (no se necesita cuenta)

Paquete	Qué hace
`bitget-signal`	5 habilidades de análisis de mercado — macro, on-chain, sentimiento, técnico, noticias

Todos los paquetes tienen licencia MIT y son de uso gratuito. Se pueden instalar en paralelo sin conflictos.

Instalador

@bitget-ai/bitget-agent-installer es la meta-herramienta del ecosistema. Un solo comando instala, actualiza, revierte y despliega los paquetes de Bitget Agent Hub en tus herramientas de IA — sin necesidad de instalar cada paquete y ejecutar la configuración de cada habilidad manualmente.

npx @bitget-ai/bitget-agent-installer

Ejecútalo sin argumentos para un menú interactivo, o pasa un comando directamente (ver más abajo).

Qué gestiona

Paquete	Rol
`bitget-agent-cli`	La CLI de trading de terminal `bgc`
`bitget-agent-skill`	Guía de razonamiento de trading para IA de terminal
`bitget-signal`	Habilidades de análisis de mercado (sin clave API)

La IA de escritorio usa bitget-agent-mcp, que se registra en la configuración de tu cliente MCP en lugar de instalarse globalmente — configúralo directamente a través del paquete MCP. bitget-agent-sdk es una dependencia de biblioteca y no requiere instalación por separado.

Por qué usarlo

Un comando para todo el ecosistema — instala, actualiza o revierte todos los paquetes juntos.
Siempre actualizado — resuelve automáticamente la última versión publicada de cada paquete; no hay nada que fijar, por lo que las versiones diferentes entre paquetes simplemente funcionan.
Despliegue de habilidades integrado — conecta las habilidades directamente en Claude Code, Codex y OpenClaw mediante --target.
Reversible — revierte cualquier paquete a una versión publicada anteriormente.
Seguro de previsualizar — --dry-run imprime cada comando sin ejecutarlo.
Ligero — un único script sin dependencias ejecutado con npx; detecta automáticamente npm o pnpm.

Comandos

Comando	Qué hace
(sin argumentos)	Menú interactivo — actualizar, revertir o desplegar habilidades
`upgrade-all [--target <tools>]`	Instala o actualiza todos los paquetes gestionados a la última versión
`upgrade <pkg> [--target <tools>]`	Instala o actualiza un paquete a la última versión
`rollback <pkg> --to <version>`	Cambia un paquete a una versión publicada específica
`install [pkg] [--target <tools>]`	Despliega las habilidades de un paquete ya instalado en tus herramientas de IA

Banderas

--target <tools> — dónde desplegar habilidades: claude, codex, openclaw, all (separadas por comas; predeterminado claude)
--dry-run — previsualiza comandos sin ejecutarlos
--version · --help

Ejemplos

# Install everything and deploy skills to every supported AI tool
npx @bitget-ai/bitget-agent-installer upgrade-all --target all

# Update just the CLI to the latest version
npx @bitget-ai/bitget-agent-installer upgrade @bitget-ai/bitget-agent-cli

# Roll the CLI back to the pre-v3 release
npx @bitget-ai/bitget-agent-installer rollback @bitget-ai/bitget-agent-cli --to 1.2.0

# Deploy already-installed market-signal skills into Claude Code and Codex
npx @bitget-ai/bitget-agent-installer install @bitget-ai/bitget-signal --target claude,codex

# Preview an upgrade without changing anything
npx @bitget-ai/bitget-agent-installer upgrade-all --target all --dry-run

Herramientas de trading

Deja que un agente de IA opere Bitget por ti automáticamente

Las herramientas de trading de Bitget Agent Hub exponen 89 operaciones de UTA v3 a través de 14 verbos de intención seleccionados:

Pregunta a tu IA	Qué hace
"Compra 0.1 BTC al precio de mercado"	Orden de mercado al contado
"Abre un largo de BTC, apalancamiento 10x"	Posición de futuros
"Consulta mi saldo"	Resumen de cuenta
"Transfiere USDT a futuros"	Transferencia interna de fondos
"Cancela todas las órdenes abiertas"	Cancelación por lotes

Elige tu entorno de IA

Tu IA vive en…	Paquete instalado
IA de terminal: Claude Code, Codex CLI, OpenClaw	`bitget-agent-cli` + `bitget-agent-skill`
IA de escritorio: Claude Desktop, Cursor, Continue, Windsurf, ChatGPT Desktop	`bitget-agent-mcp`

Comienza

Crea una clave API de Bitget en bitget.com/api-management
Ejecuta el asistente del instalador o sigue la documentación de cada paquete
Verifica la instalación preguntando a tu IA: "¿Qué herramientas de Bitget están disponibles?"

¿Es tu primera vez? Crea una clave API de demostración y usa --paper-trading para practicar antes de tocar fondos reales.

Herramientas de mercado

Deja que un agente de IA monitoree y analice el mercado en tiempo real

bitget-signal añade 5 habilidades de análisis de mercado — sin cuenta de Bitget, sin clave API requerida:

Pregunta a tu IA	Habilidad
"¿Cómo afecta la política de la Fed a BTC?"	`macro-analyst`
"¿Están moviendo activos las ballenas en cadena?"	`market-intel`
"¿El mercado tiene miedo o codicia?"	`sentiment-analyst`
"¿Está BTC en sobrecompra según el RSI?"	`technical-analysis`
"¿Qué es importante en cripto hoy?"	`news-briefing`

Comienza

npx @bitget-ai/bitget-signal --target all

Reinicia tu herramienta de IA y luego pregunta sobre las condiciones del mercado.

Próximamente

Señales exclusivas de Bitget:

top-trader-flow: Posicionamiento de los líderes del copy-trading
derivatives-structure: Base de perpetuos y estructura de plazos
large-flow-detect: Detección de órdenes de tamaño ballena

Arquitectura

graph TD
    subgraph Surfaces
        A[bitget-agent-cli<br/>Terminal AI]
        B[bitget-agent-mcp<br/>Desktop AI MCP]
        C[bitget-agent-skill<br/>AI Reasoning Guide]
    end
    
    subgraph Foundation
        D[bitget-agent-sdk<br/>TypeScript SDK]
    end
    
    subgraph MarketAnalysis
        E[bitget-signal<br/>5 Analysis Skills]
    end
    
    A --> D
    B --> D
    C --> A
    D --> F[Bitget UTA v3 API]
    E --> G[Public Market-Data MCP<br/>no API key]
    
    style D fill:#f9f,stroke:#333,stroke-width:2px
    style F fill:#bbf,stroke:#333,stroke-width:2px

Cómo funciona:

SDK (bitget-agent-sdk): Capa base con 89 operaciones, firma HMAC, limitación de velocidad
CLI (bitget-agent-cli): Herramienta de línea de comandos para terminal construida sobre el SDK
MCP (bitget-agent-mcp): Servidor de IA de escritorio construido sobre el SDK
Habilidad (bitget-agent-skill): Enseña a la IA de terminal a usar la CLI correctamente
Señal (bitget-signal): Análisis de mercado independiente mediante un servicio MCP de datos de mercado público sin clave

Operaciones compatibles

Basado en la API de Bitget UTA v3 — 89 operaciones mediante 14 verbos de intención seleccionados:

Módulo	Predeterminado	Verbos de intención	Requiere clave API
market	✅	`market`	No (datos públicos)
trade	✅	`order`, `position`, `strategy_order`	Sí
account	✅	`account_overview`, `transfer_funds`, …	Sí
strategy	—	mediante `raw`	Sí
cryptoloans	—	`loan`	Sí
tax	—	`tax`	Sí

strategy_order está controlado por el módulo trade — colocar órdenes de estrategia es una capacidad de trading que un agente espera siempre que el trading esté habilitado; las demás operaciones del módulo strategy siguen siendo accesibles mediante raw.

Además, meta-herramientas: discover (explorar operaciones) y raw (llamar cualquier operación por operationId).

Explora el catálogo en vivo en cualquier momento con bgc discover (o discover en cualquier superficie).

Seguridad

Protección de credenciales

✅ Nunca sale de tu máquina: las claves API se leen solo de variables de entorno
✅ Firma local: todas las solicitudes autenticadas se firman con HMAC-SHA256 en el proceso
✅ Sin análisis de .env: las herramientas no leen archivos .env para evitar fugas
✅ Sin proxy: conexión directa a la API oficial de Bitget

Modos de seguridad

--read-only: elimina todas las herramientas de escritura al inicio — la IA no puede colocar órdenes ni transferencias
--paper-trading: enruta al entorno de demostración de Bitget — sin fondos reales involucrados
Limitación de velocidad: la limitación integrada del lado del cliente evita el abuso de la API

Mejores prácticas

Usa primero una clave API de demostración para probar
Comienza con el modo --read-only para verificar consultas
Nunca confirmes credenciales en el control de versiones
Rota las claves API cada 90 días

Documentación

Tema	Documento
Primeros pasos	docs/getting-started.md
Arquitectura del ecosistema	docs/architecture.md

Las referencias por paquete — banderas de CLI, configuración del cliente MCP, API del SDK, habilidades de señal — viven en el repositorio de cada paquete (consulta la tabla Ecosistema anterior). La superficie de herramientas en vivo siempre se puede explorar con bgc discover (o discover en cualquier superficie).

Enlaces

Bitget: bitget.com
Documentación de API: bitget.com/api-doc
Model Context Protocol: modelcontextprotocol.io
Todos los repositorios de IA de Bitget: github.com/Bitget-AI

Preguntas frecuentes

¿Qué es Bitget Agent Hub?

Bitget Agent Hub es el ecosistema oficial de agentes de IA de código abierto de Bitget. Conecta las capacidades de trading de criptomonedas de Bitget y los datos de mercado en tiempo real a agentes de IA como Claude, Cursor, Codex y ChatGPT — cubriendo 89 operaciones de UTA v3 mediante 14 verbos de intención seleccionados, además de habilidades de análisis de mercado sin necesidad de cuenta.

¿Cómo sé qué paquete instalar?

Depende de tu herramienta de IA:

IA de terminal (Claude Code, Codex) → bitget-agent-cli + bitget-agent-skill
IA de escritorio (Claude Desktop, Cursor) → bitget-agent-mcp
Solo análisis de mercado → bitget-signal (sin clave API necesaria)
Desarrollador que construye herramientas personalizadas → bitget-agent-sdk

¿Puedo usar IA para operar cripto automáticamente?

Sí. Una vez instalado, puedes decirle a las herramientas de IA compatibles "compra 0.1 BTC" o "abre un largo de BTC con apalancamiento 10x" y la IA ejecutará directamente en tu cuenta de Bitget. Usa el modo --paper-trading para ensayar de forma segura.

¿Es seguro conectar mi clave API?

Sí. Las credenciales:

Se leen solo de variables de entorno
Nunca pasan por ningún servidor proxy
Se firman localmente con HMAC-SHA256
Nunca se registran ni se escriben en disco

¿Cómo evito órdenes accidentales?

Añade --read-only al inicio. Todas las herramientas de escritura se eliminan por completo — la IA no puede verlas ni llamarlas.

¿Qué herramientas de IA son compatibles?

Claude Desktop, Claude Code, Cursor, Codex CLI, Continue, Windsurf, ChatGPT Desktop, OpenClaw y cualquier cliente compatible con MCP.

¿Es gratuito?

Todos los paquetes tienen licencia MIT y son de uso gratuito. bitget-signal es mantenido por Bitget y de uso gratuito — sin clave API, sin cuenta.

¿Cómo actualizo todo?

Ejecuta npx @bitget-ai/bitget-agent-installer y elige actualizar, o:

npx @bitget-ai/bitget-agent-installer upgrade-all --target all

Contribuciones

Las issues y las pull requests son bienvenidas.

Reporta errores o solicita funciones: GitHub Issues
Problemas de seguridad: envía un correo a security@bitget.com (no lo publiques públicamente)

Licencia

Licencia MIT — Gratuita para uso personal y comercial. Se agradece la atribución, pero no es obligatoria.

_{⚠️ Aviso de riesgo: Operar con criptomonedas y acciones tokenizadas conlleva un riesgo sustancial. Eres el único responsable de cualquier orden que tu agente de IA realice en tu nombre. Usa siempre los modos --read-only y --paper-trading para ensayar de forma segura antes de operar en vivo.}

_{Bitget Agent Hub es un proyecto oficial de código abierto de Bitget · Parte del ecosistema de IA de Bitget · Creado para traders, desarrolladores y entusiastas de la IA}