What can you do with this server?

This server provides tools for managing user wallets, tracking consumption trends, and accessing dashboard statistics for API usage. Wallet Management: * Wallet Overview (wallet_balance): Retrieve balance, usable balance, vouchers, credit limits, and pending amounts. * Consumption Trends (wallet_trend): View consumption trend data over a configurable number of days (default: 30 days). * Transaction Records (wallet_transactions): List wallet transactions with optional filters for date range and record type. * Cash Coupons (wallet_coupons): List all available cash coupons on the account. * Corporate Bank Info (wallet_corporate_info): Retrieve corporate transfer bank account info for recharging. Dashboard & Statistics: * Dashboard Stats: View overall usage metrics — used quota, total consumption, request count, and active users. * API Call Records: List detailed API call records with optional filtering. * User Dropdown Options: Get user options for filtering dashboard data. * Model Statistics: Access per-model usage stats including call count, token consumption, and cost.

How do I use mcp-user-system?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-user-system show my wallet balance" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-user-system

by shenda-ai

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

mcp-user-system

MCP server for token-user-system — Console 前台全量查询接口 via Model Context Protocol.

Provides AI agents with authenticated access to the Console (前台) query APIs, covering user info, dashboard statistics, wallet, team management, token usage, invoices, and miscellaneous lookups.

Supports: user profiles, dashboard stats & trends, wallet overview, team & member management, token consumption, invoice queries, and more.

Prerequisites

Node.js >= 18
TUS_BASE_URL and TUS_ACCESS_TOKEN environment variables

Related MCP server: jazzcash-mcp

Installation

1. Install globally

npm install -g mcp-user-system

Or clone & build manually:

git clone https://github.com/shenda-ai/mcp-user-system.git
cd mcp-user-system
npm install
npm run build

2. Configure Environment

export TUS_BASE_URL=https://api.example.com
export TUS_ACCESS_TOKEN=your-jwt-access-token

Or create a .env file (add to .gitignore):

TUS_BASE_URL=https://api.example.com
TUS_ACCESS_TOKEN=your-jwt-access-token

Access Token is a JWT Bearer Token obtained after user login. Include it as Authorization: Bearer <token> in upstream requests.

3. Test Run

npm start

MCP Client Configuration

Claude Desktop (macOS)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "user-system": {
      "command": "node",
      "args": ["/path/to/mcp-user-system/dist/index.js"],
      "env": {
        "TUS_BASE_URL": "https://api.example.com",
        "TUS_ACCESS_TOKEN": "your-jwt-access-token"
      }
    }
  }
}

Cursor / VS Code

Add to settings (Cursor: ~/.cursor/mcp.json, VS Code: settings.json):

{
  "mcpServers": {
    "user-system": {
      "command": "node",
      "args": ["/path/to/mcp-user-system/dist/index.js"],
      "env": {
        "TUS_BASE_URL": "https://api.example.com",
        "TUS_ACCESS_TOKEN": "your-jwt-access-token"
      }
    }
  }
}

Claude Code (CLI)

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "user-system": {
      "command": "node",
      "args": ["/path/to/mcp-user-system/dist/index.js"],
      "env": {
        "TUS_BASE_URL": "https://api.example.com",
        "TUS_ACCESS_TOKEN": "your-jwt-access-token"
      }
    }
  }
}

Available Tools

62 tools organized by domain:

Domain	Count	Description
user	6	User profile, preferences, and account info
dashboard	10	Dashboard statistics, trends, rankings, model usage, member usage
wallet	8	Wallet overview, transactions, balance history, recharge records
team	14	Team/department management, member CRUD, role & permission queries
tokens	6	Token consumption details, usage aggregation, billing records
invoice	4	Invoice list, invoice detail, red-punch status queries
misc	14	Refund management, resource rules, alert settings, message center

Authentication

This MCP server uses Access Token (JWT Bearer Token) authentication. The token is obtained after user login and passed via the TUS_ACCESS_TOKEN environment variable. All upstream API requests include it as Authorization: Bearer <token>.

Development

npm run dev      # Watch mode
npm run build    # Compile TypeScript
npm start        # Run compiled server

License

MIT

mcp-user-system

MCP server for token-user-system — Console 前台全量查询接口 via Model Context Protocol.

Provides AI agents with authenticated access to the Console (前台) query APIs, covering user info, dashboard statistics, wallet, team management, token usage, invoices, and miscellaneous lookups.

Supports: user profiles, dashboard stats & trends, wallet overview, team & member management, token consumption, invoice queries, and more.

Prerequisites

Node.js >= 18
TUS_BASE_URL and TUS_ACCESS_TOKEN environment variables

Installation

1. Install globally

npm install -g mcp-user-system

Or clone & build manually:

git clone https://github.com/shenda-ai/mcp-user-system.git
cd mcp-user-system
npm install
npm run build

2. Configure Environment

export TUS_BASE_URL=https://api.example.com
export TUS_ACCESS_TOKEN=your-jwt-access-token

Or create a .env file (add to .gitignore):

TUS_BASE_URL=https://api.example.com
TUS_ACCESS_TOKEN=your-jwt-access-token

Access Token is a JWT Bearer Token obtained after user login. Include it as Authorization: Bearer <token> in upstream requests.

3. Test Run

npm start

MCP Client Configuration

Claude Desktop (macOS)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "user-system": {
      "command": "node",
      "args": ["/path/to/mcp-user-system/dist/index.js"],
      "env": {
        "TUS_BASE_URL": "https://api.example.com",
        "TUS_ACCESS_TOKEN": "your-jwt-access-token"
      }
    }
  }
}

Cursor / VS Code

Add to settings (Cursor: ~/.cursor/mcp.json, VS Code: settings.json):

{
  "mcpServers": {
    "user-system": {
      "command": "node",
      "args": ["/path/to/mcp-user-system/dist/index.js"],
      "env": {
        "TUS_BASE_URL": "https://api.example.com",
        "TUS_ACCESS_TOKEN": "your-jwt-access-token"
      }
    }
  }
}

Claude Code (CLI)

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "user-system": {
      "command": "node",
      "args": ["/path/to/mcp-user-system/dist/index.js"],
      "env": {
        "TUS_BASE_URL": "https://api.example.com",
        "TUS_ACCESS_TOKEN": "your-jwt-access-token"
      }
    }
  }
}

Available Tools

62 tools organized by domain:

Domain	Count	Description
user	6	User profile, preferences, and account info
dashboard	10	Dashboard statistics, trends, rankings, model usage, member usage
wallet	8	Wallet overview, transactions, balance history, recharge records
team	14	Team/department management, member CRUD, role & permission queries
tokens	6	Token consumption details, usage aggregation, billing records
invoice	4	Invoice list, invoice detail, red-punch status queries
misc	14	Model list, announcements, notifications, system config, and other lookups

Authentication

Development

npm run dev      # Watch mode
npm run build    # Compile TypeScript
npm start        # Run compiled server

License

MIT

Available Tools

5 tools

wallet_balanceA

Get account wallet overview (balance, usable balance, voucher, credit limit, pending amount)

Inputs: no named parameters.

wallet_corporate_infoA

Get corporate transfer bank account info for recharge

Inputs: no named parameters.

wallet_couponsB

List my cash coupons

Inputs: no named parameters.

wallet_transactionsC

List wallet transaction records with optional filters

Inputs: endDate, startDate, recordType.

wallet_trendA

Get consumption trend for a given number of days

Inputs: days.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored 2026-07-08 04:35 across 5 tools

Disambiguation5/5

Each tool targets a distinct wallet aspect: balance overview, corporate recharge info, coupons, transaction history, and consumption trend. No overlap.

Naming Consistency5/5

All tools follow the consistent pattern 'wallet_<noun>' (e.g., wallet_balance, wallet_transactions). Perfectly uniform.

Tool Count5/5

5 tools is well-scoped for a wallet subsystem, covering essential operations without bloat.

Completeness4/5

Covers core wallet needs but lacks direct recharge/deposit or withdrawal tools, though corporate info hints at external recharge.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

tenzro
xyz.tenzro
Tenzro Network MCP server: wallet, identity, payments, inference, staking, bridges, verification.
Blockchain Cryptocurrency Payments & Billing
2
https://mcp.tenzro.xyz/mcp
Modern Treasury MCP by usefulapiB
io.usefulapi
MCP server for Modern Treasury — payment orders, transactions, counterparties and ledgers.
Finance Payments & Billing
2
https://modern-treasury.usefulapi.io/mcp
James's MCP ServerA
io.github.JGPAS
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
Cryptocurrency Finance
21
https://mcp-first-server.onrender.com/mcp
WebMoney MCP
com.webmoney
Authenticated MCP access to WebMoney wallets, transactions, messages and invoices.
Payments & Billing Finance
1
https://mcp.webmoney.com/mcp

Related MCP Servers

BCH MCP Server
Blockchain Cryptocurrency Web3 & Decentralized Tech
CashLabs-Dev
A
license
Not graded
quality
D
maintenance
A comprehensive Bitcoin Cash (BCH) MCP server that enables wallet management, transaction utilities, and full CashToken operations including genesis, minting, and burning. It also provides advanced features such as escrow contracts, smart contract documentation, and real-time currency conversion.
Updated 10 months ago (2026-01-12 05:24 UTC)
MIT
jazzcash-mcp
Finance Payments & Billing
theYahia
A
license
A
quality
B
maintenance
MCP server for JazzCash mobile wallet and payments (Pakistan). Supports wallet payments, mobile account payments, vouchers, refunds, and balance inquiries.
Updated 2 months ago (2026-09-05 10:51 UTC)
5
8 npm
1
MIT
towngas-mcp
Energy
sdrpsps
A
license
Not graded
quality
C
maintenance
MCP server for querying Towngas account data, including bills, readings, and bound accounts. Supports automatic token refresh via refresh token.
Updated 4 months ago (2026-06-26 03:35 UTC)
MIT
wallet-mcp
Finance
kirikatiya
A
license
Not graded
quality
D
maintenance
MCP server for the BudgetBakers Wallet REST API, enabling management of transactions, accounts, categories, budgets, labels, and more through natural language.
Updated 4 months ago (2026-07-18 11:05 UTC)
35 npm
MIT

mcp-user-system

Prerequisites

Installation

1. Install globally

2. Configure Environment

3. Test Run

MCP Client Configuration

Claude Desktop (macOS)

Cursor / VS Code

Claude Code (CLI)

Available Tools

Authentication

Development

License

mcp-user-system

Prerequisites

Installation

1. Install globally

2. Configure Environment

3. Test Run

MCP Client Configuration

Claude Desktop (macOS)

Cursor / VS Code

Claude Code (CLI)

Available Tools

Authentication

Development

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

BCH MCP Server

jazzcash-mcp

towngas-mcp

wallet-mcp