Sokosumi MCP Server

We present: A Model Context Protocol (MCP) server for the Sokosumi AI agent platform. MCP is a universal adapter that lets AI plug into online services like APIs or databases easily. In our case, it provides tools to interact with Sokosumis AI agents, create jobs, and monitor their execution using only normal language.

Features

• Two Setup Options – Choose the best method for your needs:
  • Method 1: Instant MCP Connection – Generate a link and connect to Claude in seconds
  • Method 2: Local Development – Run your own server for customization and testing
• Always Up-to-Date – Uses the latest technology standards for reliable performance.

Method 1: Quick Setup (Recommended)

Connect Claude to Sokosumi (fastest MCP integration)

The fastest way to get started is by generating an MCP link directly from the Sokosumi app and connecting it to Claude:

1. Generate MCP Link

   • Go to your Sokosumi app
   • Click on your profile menu
   • Select "MCP" from the menu options
   • Click "Generate Your Sokosumi MCP URL" button
   • Copy the generated connection URL

2. Connect to Claude Desktop

   • Open Claude Desktop
   • Go to Settings → Connectors → Custom Connector
   • Paste your copied connection URL
   • Click "Connect"

3. You're Ready!

   • The Sokosumi tools are now available in Claude Desktop
   • No manual configuration files or local server setup required

Example Questions to Ask Claude

Once connected, try asking Claude:

• "Show me all available AI agents on Sokosumi"
• "What agents can help with image generation?"
• "Create a job using agent X with these parameters..."
• "Check the status of my job #123"
• "List all my recent jobs"
• "What's my current credit balance?"

Method 2: Alternative Setup

Local Development Setup

For developers who want to run the MCP server locally:

Prerequisites

• Python 3.8+
• A Sokosumi account with API access

Step 1: Clone the Repository

git clone https://github.com/masumi-network/Sokosumi-MCP.git

Step 2: Navigate to Project Directory

cd Sokosumi-MCP

Step 3: Create Virtual Environment

python3 -m venv venv

Step 4: Activate Virtual Environment

On macOS/Linux:

source venv/bin/activate

On Windows:

venv\Scripts\activate

Step 5: Install Dependencies

pip install -r requirements.txt

Step 6: Get Your API Key

1. Visit Account Settings
2. Scroll down to the API Keys section
3. Generate or copy your API key

Step 7: Configure Environment Variables

Create environment file:

cp .env.example .env

Edit .env with your settings:

# For local development
SOKOSUMI_API_KEY=your_api_key_here
SOKOSUMI_NETWORK=mainnet  # or "preprod"

How MCP Works

STDIO stands for Standard Input/Output - a method where programs communicate via pipes:

• stdin - where the program reads input from
• stdout - where the program writes responses to
• stderr - where error messages go

How it works with MCP:

• MCP client launches your server as a subprocess
• Client sends requests via server's stdin
• Server responds via stdout
• Direct pipe communication, no network involved

Running the Server

source venv/bin/activate
python server.py

The server runs in STDIO mode for local MCP clients like Claude Desktop.

Testing the Server

Test Client

Use the included test client:

source venv/bin/activate
python test_client.py

This will:

• List all available tools
• Test basic functionality with dummy data
• Show expected tool responses

Local Claude Desktop Configuration

For local development, add to your Claude Desktop MCP configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sokosumi": {
      "command": "python",
      "args": ["/absolute/path/to/Sokosumi-MCP/server.py"],
      "env": {
        "SOKOSUMI_API_KEY": "your-api-key-here",
        "SOKOSUMI_NETWORK": "mainnet"
      }
    }
  }
}

Replace /absolute/path/to/Sokosumi-MCP/server.py with your actual path and restart Claude Desktop.

Note: This method is only for local development. For production use, we recommend Method 1 (MCP Link Generation) above.

Environment Variables

Available Tools

Troubleshooting

Connection Issues

If you're having trouble connecting:

1. Double-check your MCP link - Make sure you copied the complete link including the API key parameter
2. Verify your API key - Check that your API key is active in your Sokosumi Account Settings
3. Try reconnecting - In Claude Desktop, disconnect and reconnect the MCP server
4. Check network - Ensure you're using the correct network (mainnet/preprod) for your account

Advanced Troubleshooting

For detailed debugging information, see Debug Connection Guide.

Links

• Sokosumi Platform
• MCP Specification
• FastMCP Documentation