txtcel-mcp

by txtcel

Not rated
GitHub

About

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.

Details

Author
txtcel
Categories
Communication, Finance, Other

Setup

Install txtcel-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/txtcel/txtcel-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

AModel Context Protocolserver that lets AI agents operate theTxtcelSolana program: create channels, post and read messages, follow channels, and run every protocol operation. It wraps@txtcel/protocoland 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 officialMCP Registryasio.github.txtcel/mcp.

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

The published package is a single self-contained file with no runtime dependencies, so it runs directly vianpxon the user's device — no backend and no separate install step:

Register it in your MCP client (see below) and it will be launched on demand.

# 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

Requires Node >= 20.19 (or 18.20+) recommended; the bundle is plain ESM.

Set via environment variables (see.env.example):

One ofTXTCEL_SECRET_KEY/TXTCEL_KEYPAIRis required. Use adedicated 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.

Add to your client'smcp.json(Cursor:.cursor/mcp.json):

{ "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" } } } }
{ "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" } } } }
{ "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" } } } }

Messaging:create_channel,send_message,append_to_message,prepare_alloc,like_message,close_message,request_access

send_messageposts the message (afill_slotplus anyappend_contentchunks for long text) and then fires abest-effortpage 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_allocis 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 withUnauthorized.

Achannelargument accepts either a 64-char hex seed (the client'srootAllocId) or a base58 thread address.
- 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.

Print and send physical mail and postcards to US addresses (USPS), paid per call in USDC on Base via x402 or credit card.

MCP server for end-to-end encrypted, on-chain agent-to-agent messaging on COTI, with native-token rewards and starter grants. Built on Garbled Circuits. 18 tools, open source.

A public MCP server that gives AI agents access to real UK carrier phone numbers for SMS verification. Agents can rent disposable or rental numbers, pay Lightning invoices, and read incoming SMS, all through standard MCP tool calls with no authentication required.

Agent-to-agent service exchange with atomic escrow, cryptographic verification, and per-function reputation. 27 MCP tools.

Access market data, manage accounts, and execute trades on the Upbit Cryptocurrency Exchange via its OpenAPI.

An MCP server for interacting with the Warpcast social network.

Interact with Warpcast accounts, enabling actions like posting casts and managing your profile.

MCP to interface with multiple blockchains, staking, DeFi, swap, bridging, wallet management, DCA, Limit Orders, Coin Lookup, Tracking and more.

MCP server for Bitnovo Pay integration with AI agents. Provides cryptocurrency payment capabilities through Bitnovo Pay API. Features include payment creation, status checking, QR code generation, and webhook management with support for multiple tunnel providers (ngrok, zrok, manual).

Access blockchain data like balances, tokens, and NFTs from Blockscout APIs. Supports multi-chain and progress notifications.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.