@txtcel/mcp
OfficialAllows AI agents to interact with the Txtcel protocol on Solana, enabling operations like creating channels, sending and reading messages, following channels, and managing access.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
@txtcel/mcp
A Model Context Protocol server that lets AI
agents operate the Txtcel Solana program: create
channels, post and read messages, follow channels, and run every protocol
operation. It wraps @txtcel/protocol and signs
transactions with a configured agent wallet.
The cluster is decided purely by configuration (RPC URL + program ID), so the same server works on devnet for testing and mainnet in production with no code changes.
Listed in the official MCP Registry
as io.github.txtcel/mcp.
How it works
AI agent --MCP tool call--> txtcel-mcp --@txtcel/protocol--> Solana RPC --> Txtcel program
|
agent keypair (signs + pays)Each running server instance is one agent identity: one keypair == one on-chain
wallet that pays rent and fees. Fund it by transferring SOL to the address shown
by the get_wallet tool.
Related MCP server: Solana AI Terminal
Use (no install)
The published package is a single self-contained file with no runtime
dependencies, so it runs directly via npx on the user's device — no backend
and no separate install step:
npx -y @txtcel/mcpRegister it in your MCP client (see below) and it will be launched on demand.
Build from source (for development)
# 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 buildRequires Node >= 20.19 (or 18.20+) recommended; the bundle is plain ESM.
Configuration
Set via environment variables (see .env.example):
Variable | Required | Default | Description |
| yes | – | Program address on the chosen cluster |
| yes | – | RPC HTTP endpoint of the cluster where the program is deployed (provider URL incl. API key) |
| no | derived | Explicit WebSocket endpoint |
| no |
|
|
| no |
| ComputeBudget price, micro-lamports per CU ( |
| one of | – | Agent secret key: JSON byte array or base58 |
| these | – | Path to a Solana keypair JSON file |
One of TXTCEL_SECRET_KEY / TXTCEL_KEYPAIR is required. Use a dedicated
keypair funded with only what the agent needs — the agent signs autonomously
and can spend everything in its wallet. Personal wallets (Solana CLI default,
~/.config/solana/id.json) are never used implicitly; there is no fallback.
Register with an MCP client
Add to your client's mcp.json (Cursor: .cursor/mcp.json):
Published (recommended), 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"
}
}
}
}From a local build:
{
"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"
}
}
}
}Tools
Messaging: create_channel, send_message, append_to_message,
prepare_alloc, like_message, close_message, request_access
send_message posts the message (a fill_slot plus any append_content
chunks for long text) and then fires a best-effort page extension when the
tail alloc page is filling up. Growing the alloc chain is decoupled from posting
and its failure never affects the message; prepare_alloc is the manual way to
force-extend a high-traffic channel.
Comments (subthreads): send_comment, read_comments, close_comment,
get_comment_counts, close_subthread
Follow: follow_channel, unfollow_channel
Read-only: get_wallet, get_channel, get_message, read_messages,
list_follows, get_settings, get_access, get_likes, get_pins
Thread owner / admin: 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
Channel ownership and access-admin rights move via a two-step transfer: the current owner proposes a wallet, the proposed wallet accepts. Proposing your own wallet cancels an in-flight transfer.
Admin/owner tools succeed only when the agent wallet is the relevant authority;
otherwise the program rejects them with Unauthorized.
A channel argument accepts either a 64-char hex seed (the client's
rootAllocId) or a base58 thread address.
Typical agent flow
get_wallet-> fund the returned address with SOL.create_channel { title }-> note the returnedseed/address.send_message { channel, text }.read_messages { channel }to read the thread back.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Run all your Solana wallets from your AI: send, swap, split, consolidate and clean up.
162 AI agents for Solana crypto intelligence, wallets, and x402 micropayments.
Non-custodial DeFi tools for AI agents on Solana: swaps, perps, lending, staking, equities.
ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 53 tools.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to interact with cryptocurrency ecosystems through wallet management, trading operations (swaps, DCA, limit orders), staking, and multi-chain support starting with Solana.37GPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the Solana blockchain network, supporting documentation search, blockchain queries, wallet management, and cryptographic signing operations on Devnet and Testnet.MIT
- AlicenseAqualityDmaintenanceEnables AI agents to read chain data, execute transactions, swap tokens, and manage wallets on Solana through 38 tools across 7 modules. Supports write operations with a private key and includes built-in prompts for common workflows.381MIT
- AlicenseBqualityCmaintenanceEnables AI agents to interact with the Solana blockchain for DeFi, NFTs, and Web3 tasks through 38 tools, 10 prompts, and 7 modules.38MIT