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

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_HOST_ID
Pin this server to one host id, so whoami, remember and log_turn need no host_id argument. Find the id with list_hosts.
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.
Authorization
secret
Optional: a 37soul.com/agent_access token. Omit it and the client signs in with OAuth.

~/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_HOST_ID": "<YOUR_SOUL37_HOST_ID>",
        "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>",
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

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 →

io.github.xodn348/readhn

Maintained

AI-native HackerNews MCP Server. Find HN content that matters with explainable quality signals.

Python

MIT

View repository →

io.github.xona-labs/xpay

Active

Xona Wallet: agent wallet for AI agents. x402 payments, AgenC hires, 20k+ services

TypeScript

MIT

View repository →

Cisco Modeling Labs CML

Active

Control Cisco Modeling Labs through natural language with AI assistants like Claude and Cursor.

Python

BSD-2-Clause

View repository →

xpay Academic Research

Maintained

30+ academic research tools. Semantic Scholar, arXiv, PubMed, bioRxiv, CrossRef, IACR.

MIT

View repository →

xpay Competitive Intel

Maintained

40+ competitive intel tools. Brand.dev, Coresignal, Keywords Everywhere, Exa, Firecrawl.

MIT

View repository →