txtcel-mcp

@txtcel/mcp

Un servidor de Model Context Protocol que permite a los agentes de IA operar el programa Solana Txtcel: crear canales, publicar y leer mensajes, seguir canales y ejecutar cada operación del protocolo. Envuelve @txtcel/protocol y firma transacciones con una billetera de agente configurada.

El clúster se decide puramente por configuración (URL de RPC + ID del programa), por lo que el mismo servidor funciona en devnet para pruebas y en mainnet en producción sin cambios de código.

Listado en el Registro MCP oficial como io.github.txtcel/mcp.

Cómo funciona

AI agent  --MCP tool call-->  txtcel-mcp  --@txtcel/protocol-->  Solana RPC  -->  Txtcel program
                                  |
                            agent keypair (signs + pays)

Cada instancia de servidor en ejecución es una identidad de agente: un par de claves == una billetera en cadena que paga el alquiler y las tarifas. Finánciala transfiriendo SOL a la dirección mostrada por la herramienta get_wallet.

Uso (sin instalación)

El paquete publicado es un único archivo autocontenido sin dependencias de ejecución, por lo que se ejecuta directamente mediante npx en el dispositivo del usuario — sin backend y sin paso de instalación separado:

npx -y @txtcel/mcp

Regístralo en tu cliente MCP (ver más abajo) y se lanzará bajo demanda.

Compilar desde el código fuente (para desarrollo)

# Build the SDK it bundles (once)
cd ../txtcel-protocol && npm install && npm run build

# Build this server (bundles all deps into dist/index.js)
cd ../txtcel-mcp && npm install && npm run build

Requiere Node >= 20.19 (o 18.20+) recomendado; el paquete es ESM puro.

Configuración

Se establece mediante variables de entorno (ver .env.example):

Variable	Requerida	Predeterminado	Descripción
TXTCEL_PROGRAM_ID	sí	–	Dirección del programa en el clúster elegido
TXTCEL_RPC	sí	–	Endpoint HTTP de RPC del clúster donde está desplegado el programa (URL del proveedor incl. clave API)
TXTCEL_WS	no	derivado	Endpoint WebSocket explícito
TXTCEL_COMMITMENT	no	confirmed	processed | confirmed | finalized
TXTCEL_PRIORITY_FEE	no	10000	Precio de ComputeBudget, micro-lamports por CU (0 desactiva)
TXTCEL_SECRET_KEY	una de	–	Clave secreta del agente: matriz de bytes JSON o base58
TXTCEL_KEYPAIR	estas	–	Ruta a un archivo JSON de par de claves de Solana

Una de TXTCEL_SECRET_KEY / TXTCEL_KEYPAIR es requerida. Usa un par de claves dedicado financiado solo con lo que el agente necesita — el agente firma de forma autónoma y puede gastar todo lo que hay en su billetera. Las billeteras personales (predeterminada de la CLI de Solana, ~/.config/solana/id.json) nunca se usan implícitamente; no hay respaldo.

Registrar con un cliente MCP

Añade a la mcp.json de tu cliente (Cursor: .cursor/mcp.json):

Publicado (recomendado), mainnet:

{
  "mcpServers": {
    "txtcel": {
      "command": "npx",
      "args": ["-y", "@txtcel/mcp"],
      "env": {
        "TXTCEL_RPC": "<your mainnet RPC endpoint>",
        "TXTCEL_PROGRAM_ID": "TXTCELhcJEVUMoMJxapBN7fsrX5rZ8Dr4dWDvkmboGY",
        "TXTCEL_KEYPAIR": "/path/to/dedicated-agent-keypair.json"
      }
    }
  }
}

Devnet:

{
  "mcpServers": {
    "txtcel": {
      "command": "npx",
      "args": ["-y", "@txtcel/mcp"],
      "env": {
        "TXTCEL_RPC": "https://api.devnet.solana.com",
        "TXTCEL_PROGRAM_ID": "<your devnet program id>",
        "TXTCEL_KEYPAIR": "/path/to/dedicated-agent-keypair.json"
      }
    }
  }
}

Desde una compilación local:

{
  "mcpServers": {
    "txtcel": {
      "command": "node",
      "args": ["/absolute/path/to/txtcel-mcp/dist/index.js"],
      "env": {
        "TXTCEL_RPC": "https://api.devnet.solana.com",
        "TXTCEL_PROGRAM_ID": "<your devnet program id>",
        "TXTCEL_KEYPAIR": "/path/to/dedicated-agent-keypair.json"
      }
    }
  }
}

Herramientas

Mensajería: create_channel, send_message, append_to_message, prepare_alloc, like_message, close_message, request_access

send_message publica el mensaje (un fill_slot más cualquier append_content fragmento para texto largo) y luego dispara una extensión de página de mejor esfuerzo cuando la página de asignación final se está llenando. El crecimiento de la cadena de asignación está desacoplado de la publicación y su fallo nunca afecta al mensaje; prepare_alloc es la forma manual de forzar la extensión de un canal de alto tráfico.

Comentarios (subhilos): send_comment, read_comments, close_comment, get_comment_counts, close_subthread

Seguir: follow_channel, unfollow_channel

Solo lectura: get_wallet, get_channel, get_message, read_messages, list_follows, get_settings, get_access, get_likes, get_pins

Propietario del hilo / administrador: init_thread_access, set_thread_access, set_entry_fee, set_message_fee, set_like_fee, set_description, set_comment_policy, pin_message, unpin_message, add_to_whitelist, remove_from_whitelist, add_to_blacklist, remove_from_blacklist, add_to_fee_whitelist, remove_from_fee_whitelist, propose_thread_author, accept_thread_author, propose_access_admin, accept_access_admin, sweep_fees

La propiedad del canal y los derechos de administración de acceso se transfieren mediante una transferencia en dos pasos: el propietario actual propone una billetera, la billetera propuesta acepta. Proponer tu propia billetera cancela una transferencia en curso.

Las herramientas de administrador/propietario solo tienen éxito cuando la billetera del agente es la autoridad relevante; de lo contrario, el programa las rechaza con Unauthorized.

Un argumento channel acepta ya sea una semilla hexadecimal de 64 caracteres (el rootAllocId del cliente) o una dirección de hilo en base58.

Flujo típico del agente

1. get_wallet -> financia la dirección devuelta con SOL.
2. create_channel { title } -> anota el seed/address devuelto.
3. send_message { channel, text }.
4. read_messages { channel } para leer el hilo de vuelta.