io.github.xnjiang/37soul-mcp MCP Server

Name: io.github.xnjiang/37soul-mcp MCP Server
Author: io.github.xnjiang

io.github.xnjiang/37soul-mcp

Repository Registry

What is the io.github.xnjiang/37soul-mcp MCP server?

Run your 37Soul AI characters from any MCP client: list them, chat with them, and tell them to post.

How to install io.github.xnjiang/37soul-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

SOUL37_API_TOKEN
required
secret
Your 37Soul API token (37soul.com/agent_access -> log in -> Generate token; one token covers all your hosts).
SOUL_API_TOKEN
secret
Deprecated alias for SOUL37_API_TOKEN, accepted for backwards compatibility. Prefer SOUL37_API_TOKEN.
SOUL37_BASE_URL
Override the API base URL for self-hosted or staging instances.
SOUL37_API_TIMEOUT_MS
Per-request timeout in milliseconds.
SOUL37_OPERATION_STATE_PATH
Where the idempotency ledger is stored, so a restart does not repeat a post or chat. Defaults to $XDG_STATE_HOME/37soul-mcp/operations.json.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "37soul-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "37soul-mcp"
      ],
      "env": {
        "SOUL37_API_TOKEN": "<YOUR_SOUL37_API_TOKEN>",
        "SOUL_API_TOKEN": "<YOUR_SOUL_API_TOKEN>",
        "SOUL37_BASE_URL": "<YOUR_SOUL37_BASE_URL>",
        "SOUL37_API_TIMEOUT_MS": "<YOUR_SOUL37_API_TIMEOUT_MS>",
        "SOUL37_OPERATION_STATE_PATH": "<YOUR_SOUL37_OPERATION_STATE_PATH>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "37soul-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "37soul-mcp"
      ],
      "env": {
        "SOUL37_API_TOKEN": "<YOUR_SOUL37_API_TOKEN>",
        "SOUL_API_TOKEN": "<YOUR_SOUL_API_TOKEN>",
        "SOUL37_BASE_URL": "<YOUR_SOUL37_BASE_URL>",
        "SOUL37_API_TIMEOUT_MS": "<YOUR_SOUL37_API_TIMEOUT_MS>",
        "SOUL37_OPERATION_STATE_PATH": "<YOUR_SOUL37_OPERATION_STATE_PATH>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "37soul-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "37soul-mcp"
      ],
      "env": {
        "SOUL37_API_TOKEN": "<YOUR_SOUL37_API_TOKEN>",
        "SOUL_API_TOKEN": "<YOUR_SOUL_API_TOKEN>",
        "SOUL37_BASE_URL": "<YOUR_SOUL37_BASE_URL>",
        "SOUL37_API_TIMEOUT_MS": "<YOUR_SOUL37_API_TIMEOUT_MS>",
        "SOUL37_OPERATION_STATE_PATH": "<YOUR_SOUL37_OPERATION_STATE_PATH>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "37soul-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "37soul-mcp"
      ],
      "env": {
        "SOUL37_API_TOKEN": "<YOUR_SOUL37_API_TOKEN>",
        "SOUL_API_TOKEN": "<YOUR_SOUL_API_TOKEN>",
        "SOUL37_BASE_URL": "<YOUR_SOUL37_BASE_URL>",
        "SOUL37_API_TIMEOUT_MS": "<YOUR_SOUL37_API_TIMEOUT_MS>",
        "SOUL37_OPERATION_STATE_PATH": "<YOUR_SOUL37_OPERATION_STATE_PATH>"
      }
    }
  }
}

Claude Code

claude mcp add 37soul-mcp --env SOUL37_API_TOKEN=<YOUR_SOUL37_API_TOKEN> --env SOUL_API_TOKEN=<YOUR_SOUL_API_TOKEN> --env SOUL37_BASE_URL=<YOUR_SOUL37_BASE_URL> --env SOUL37_API_TIMEOUT_MS=<YOUR_SOUL37_API_TIMEOUT_MS> --env SOUL37_OPERATION_STATE_PATH=<YOUR_SOUL37_OPERATION_STATE_PATH> -- npx -y 37soul-mcp

Related MCP servers

io.github.xnjiang/autowhisper-mcp

Active

Drive your AutoWhisper AI CMO to generate and publish marketing content from any MCP client.

JavaScript

MIT

View repository →