How do I deploy sokosumi-mcp on Railway?

You can deploy sokosumi-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: sokosumi-mcp-5a253d95, or click "Get template help" for this template for more assistance.

Deploy and Host sokosumi-mcp on Railway

Sokosumi-MCP is a Model Context Protocol (MCP) server that provides AI agents access to the Sokosumi platform. It enables remote interaction with AI agents, job creation, monitoring, and management through a standardized MCP interface with dual transport support.

About Hosting sokosumi-mcp

Hosting sokosumi-mcp involves deploying a FastMCP server that bridges MCP clients (like Claude Desktop) with the Sokosumi AI agent platform. The server automatically handles API authentication via URL parameters, supports both mainnet and preprod environments, and provides six core tools for agent interaction. Railway deployment enables remote MCP access through HTTP transport, making it accessible to any MCP-compatible client without local configuration. The server includes middleware for parameter extraction, comprehensive error handling, and built-in logging for monitoring API interactions.

Common Use Cases

Connect Claude Desktop or other MCP clients to Sokosumi AI agents remotely
Automate AI agent job creation and monitoring through standardized MCP tools
Build custom applications that interact with Sokosumi agents via MCP protocol
Provide team access to Sokosumi platform through a centralized MCP endpoint
Integrate Sokosumi AI capabilities into existing MCP-compatible workflows

Dependencies for sokosumi-mcp Hosting

Python 3.8+ runtime environment
Sokosumi platform API key (from Account Settings)
Public HTTP access for MCP client connections

Deployment Dependencies

Sokosumi Platform Account - Required for API access
Model Context Protocol Specification - Protocol documentation
FastMCP Framework - Underlying MCP server framework

Implementation Details

The server uses FastMCP with dual transport support:

# Automatic transport selection based on PORT environment variable
port = os.environ.get("PORT")
if port:
    # HTTP transport for Railway deployment
    app = mcp.streamable_http_app()
    app.add_middleware(APIKeyExtractorMiddleware)
    uvicorn.run(app, host="0.0.0.0", port=int(port))
else:
    # STDIO transport for local development
    mcp.run()

API key extraction from URL parameters:

# Middleware automatically extracts credentials
# Example: ?api_key=xxx&amp;network=mainnet
api_key = request.query_params.get('api_key')
network = request.query_params.get('network', 'mainnet')

Why Deploy sokosumi-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 sokosumi-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.