How do I deploy TezosX-mcp on Railway?

You can deploy TezosX-mcp on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: tezos-x-mcp-7dc84d4e, or join our Discord community for more assistance.

Deploy and Host tezosx-mcp on Railway

TezosX-MCP is a Model Context Protocol (MCP) server that enables AI agents to interact with the Tezos blockchain. It provides wallet tools for sending XTZ, checking balances, viewing transaction history, and supports the x402 payment protocol for seamless pay-per-request micropayments.

About Hosting tezosx-mcp

Deploying tezosx-mcp on Railway provides a hosted MCP server that AI agents can connect to via HTTP transport. The server requires configuration through environment variables including your Tezos network selection (mainnet or shadownet), a spending limit contract address for controlled fund management, and a private key for signing transactions. Railway handles the Node.js runtime, making deployment straightforward. The server also serves a web-based frontend dashboard for monitoring wallet activity and configuring your spending keys/limits.

Common Use Cases

AI agents autonomously sending XTZ payments on the Tezos blockchain with spending limits
Automated x402 micropayments for pay-per-request APIs and gated content
Monitoring wallet balances and transaction history through AI assistants

Dependencies for tezosx-mcp Hosting

Node.js >= 18
A Tezos spending limit contract (deployed separately via frontend)

Deployment Dependencies

GitHub Repo

Implementation Details

Required environment variables:

TEZOS_NETWORK=shadownet # or "mainnet"

SPENDING_CONTRACT=KT1... # Your spending limit contract address

SPENDING_PRIVATE_KEY=edsk... # Private key (edsk/spsk/p2sk format)

MCP_TRANSPORT=http # Required for Railway deployment

WEB_PORT=13205 # Optional, defaults to 13205

Why Deploy tezosx-mcp on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying tezosx-mcp on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.