emoment-mcp

MCP server for Emoment and DA APIs.

Expose 1114 tools (692 Emoment + 422 DA) via the Model Context Protocol.

Install

npm install -g emoment-mcp

Or run directly without install:

npx emoment-mcp

Quick Start

1. Set credentials

export EMOMENT_PHONE=your_phone_number
export EMOMENT_PASSWORD=your_password

The server auto-fetches token from /api/authentication/verfiy_password_login_by_phone on first use.

2. Run

Stdio mode (for Claude Desktop, Cursor, etc.):

emoment-mcp

HTTP mode (for web integration):

export HTTP_PORT=3000
emoment-mcp-http

Then open http://localhost:3000/sse for SSE endpoint.

Claude Desktop Config

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "emoment": {
      "command": "npx",
      "args": ["-y", "emoment-mcp"],
      "env": {
        "EMOMENT_PHONE": "your_phone_number",
        "EMOMENT_PASSWORD": "your_password"
      }
    }
  }
}

Authentication

Credential priority (highest to lowest):

1. Environment variables: EMOMENT_PHONE / EMOMENT_PASSWORD
2. Tool body: Pass phone and login_account_pwd in the request body (auto-cached for reuse)

If neither is set, the server will report a missing credential error.

Token Auto-Refresh

When a tool call returns 401 / 403 (HTTP status) or err_code: 401 / err_code: 1001 (API response), the server will:

1. Automatically clear the cached token
2. Re-login with the stored phone/password
3. Retry the original request once

Available Tools

All tools follow the pattern emoment_<tag>_<action> or da_<tag>_<action>.

Examples:

• emoment_event_get_event — Get event details
• emoment_invitation_create_invitation_code — Create invitation code
• emoment_user_upload_user — Bulk import attendees
• da_content_get_all_seasons — List all seasons
• da_admin_get_bindding_list — Get event bindings

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | EMOMENT_PHONE | Yes* | Your Emoment login phone number | | EMOMENT_PASSWORD | Yes* | Your Emoment login password | | HTTP_PORT | No | HTTP server port (default: 3000) |

*If not set via environment, you must pass phone and login_account_pwd in the tool body on the first call.

License

MIT