Skip to main content
Glama

DemoDesk MCP · a tiny MCP server you can read in 2 minutes

A pretend SaaS called DemoDesk, with 8 demo customers (made-up people, no real data, no API keys). The MCP server gives Claude 3 read-only tools:

Tool

Ask Claude

What it returns

signups_this_week

"How many people signed up this week?"

the signups of the last 7 days

find_customer

"Find riya@example.com"

plan, monthly payment, status, signup date

revenue_summary

"What's our MRR by plan?"

monthly revenue from active customers, per plan

Run it

git clone https://github.com/sushmareshamwala/mcp-demo && cd mcp-demo
npm install
npm test          # starts the server like Claude would and calls all 3 tools

Related MCP server: CSM Intelligence MCP Server

Connect it to Claude Code

claude mcp add demodesk -- node /full/path/to/mcp-demo/index.js

Open Claude Code, type /mcp to see demodesk connected, then ask: "How many people signed up this week?"

Connect it to Claude Desktop

Settings → Developer → Edit Config, add:

{
  "mcpServers": {
    "demodesk": { "command": "node", "args": ["/full/path/to/mcp-demo/index.js"] }
  }
}

Restart Claude Desktop.

How it works (the whole idea)

  1. index.js creates an MCP server and registers 3 tools with server.registerTool(name, { description, inputSchema }, handler).

  2. Claude reads each tool's description and decides when to call it.

  3. The server runs the handler and sends back text. Claude turns it into a plain-words answer.

To make your own SaaS's MCP server: replace data.js with calls to your real API or database, and keep every tool small and clearly described. Start read-only.

Built with the official TypeScript SDK @modelcontextprotocol/sdk (v1.31). MIT licence.

Available Tools

3 tools
find_customerFind customerB
Read-only

Find a customer by email and show their plan, monthly payment, status and signup date.

Inputs: email (required).

revenue_summaryRevenue summaryA
Read-only

Monthly recurring revenue (MRR) from active customers, split by plan.

Inputs: no named parameters.

signups_this_weekSignups this weekA
Read-only

List the customers who signed up in the last 7 days, newest first.

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a clearly distinct question: recent signups, single-customer lookup by email, and aggregate revenue by plan. There is no realistic way to confuse these three operations, and the descriptions reinforce the separation.

    Naming Consistency3/5

    Only one tool follows a verb_noun pattern (find_customer), while signups_this_week and revenue_summary are noun phrases describing reports. All are snake_case and readable, but the verb convention is not applied uniformly.

    Tool Count3/5

    Three tools is on the thin side for a customer/revenue desk, though it covers the three core read questions. It feels like a minimal dashboard slice rather than a full tool surface.

    Completeness2/5

    The surface is read-only and missing obvious lifecycle operations: no listing or searching all customers, no arbitrary date ranges, no create/update of customer or plan data, and no churn or payment detail. Agents hitting anything beyond the three canned queries will dead-end.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables querying MRR, churn, and revenue from Stripe, Gumroad, and Lemon Squeezy directly inside Claude, allowing natural language questions about business metrics.
      5
      61 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes simulated Salesforce CRM data as MCP tools for Claude Desktop, enabling customer success managers to prioritize at-risk accounts, review opportunities, cases, and Gong notes via natural language.
      -
    • F
      license
      A
      quality
      C
      maintenance
      Enables Claude to manage customers and support tickets through database-backed CRUD tools, contextual customer and knowledge resources, and a reusable ticket-triage prompt.
      13
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude Desktop and Claude Code to inspect a Postgres schema and run read-only SQL queries against a demo database through the tools describe_schema and query_readonly. Every proposed query passes the same deterministic guardrails — SELECT-only, allow-listed tables, enforced row limits, statement timeouts and a read-only role — before execution.
      2
      MIT