How do I use Nimbus MCP Server?

1. Click on "Install 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., "@Nimbus MCP Server Look up the user account for sarah.chen@example.com" 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.

Nimbus MCP Server

by 23viv

Overview Schema Source Related Servers Score Discussions Admin

Python

Hybrid

🔧 Nimbus MCP Server

Standalone Model Context Protocol (MCP) server for the Nimbus Furniture platform.

Provides live user account lookup tools over HTTP, consumed by the nimbus_agent AI support agent.

What is this?

The nimbus_mcp service is a lightweight, independently deployable HTTP server that exposes two tools via FastMCP:

Tool	Description
`get_user_by_email`	Look up a Nimbus customer account by email address
`get_user_account_status`	Retrieve plan type, account status, and plan details by user ID

The agent calls these tools at runtime over HTTP using the MCP protocol — keeping live user data completely separate from the AI agent logic.

Related MCP server: Ticket Support MCP Server

Project Structure

nimbus_mcp/
├── server.py          # FastMCP server — defines and exposes MCP tools
├── data/
│   └── users.json     # Nimbus customer database (8 mock users)
├── requirements.txt   # Minimal dependencies (fastmcp, mcp, python-dotenv)
├── .gitignore
└── README.md

Tools Exposed

`get_user_by_email(email: str) → dict`

Looks up a customer by their email address.

Returns:

{
  "found": true,
  "id": "usr_001",
  "name": "Sarah Chen",
  "email": "sarah.chen@example.com",
  "plan": "premium",
  "account_status": "active",
  "last_login": "2026-08-03T10:22:14Z",
  "created_at": "2024-03-15T08:00:00Z",
  "total_orders": 12,
  "store_credit": 25.00
}

If not found:

{ "found": false, "error": "No Nimbus Furniture account found for email: x@x.com" }

`get_user_account_status(user_id: str) → dict`

Returns plan and status details for a user by ID.

Returns (Free plan):

{
  "found": true,
  "id": "usr_002",
  "name": "James Patel",
  "plan": "free",
  "account_status": "active",
  "plan_details": "Nimbus Free: standard shipping rates apply, White Glove Delivery available for $49/item, regular support. Upgrade to Nimbus Premium for $9.99/month..."
}

Returns (Premium plan):

{
  "found": true,
  "id": "usr_001",
  "name": "Sarah Chen",
  "plan": "premium",
  "account_status": "active",
  "plan_details": "Nimbus Premium: free standard shipping on all furniture orders, free White Glove Delivery & assembly on large items, 10% member discount..."
}

Returns (Suspended):

{
  "found": true,
  "id": "usr_004",
  "name": "Derek Kim",
  "plan": "free",
  "account_status": "suspended",
  "suspension_reason": "Payment dispute — account under review",
  "plan_details": "..."
}

Setup

1. Prerequisites

Python 3.10+

2. Create a virtual environment

python -m venv venv

# Windows
venv\Scripts\activate

# macOS / Linux
source venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

4. Configure environment variables (optional)

The only configurable variable is the port. Create a .env file if needed:

MCP_SERVER_PORT=8001

The default port is 8001 if not set.

Running Locally

python server.py

The MCP server starts at:

http://127.0.0.1:8001/mcp

To verify it's running, check the console output:

INFO:     Started server process
INFO:     Uvicorn running on http://127.0.0.1:8001

⚠️ Always start nimbus_mcp before nimbus_agent. The agent connects to this server on startup and falls back to RAG-only mode if it can't reach it.

Deploying to Render

Deploy as a Web Service from your GitHub repo:

Setting	Value
Root Directory	`nimbus_mcp`
Build Command	`pip install -r requirements.txt`
Start Command	`python server.py`
Port	`8001`

Environment variable to set in Render dashboard:

MCP_SERVER_PORT=8001

After deploying, copy the public URL (e.g. https://nimbus-mcp.onrender.com) and set the following in your nimbus_agent Render service:

MCP_SERVER_URL=https://nimbus-mcp.onrender.com/mcp

⚠️ Deploy nimbus_mcp first, then deploy nimbus_agent. The agent needs the MCP URL to be live at startup.

Updating the User Database

The user data lives in data/users.json. Each user record follows this schema:

{
  "id": "usr_001",
  "email": "user@example.com",
  "name": "Full Name",
  "plan": "premium | free",
  "account_status": "active | suspended",
  "last_login": "2026-08-03T10:22:14Z",
  "created_at": "2024-03-15T08:00:00Z",
  "total_orders": 12,
  "store_credit": 25.00,
  "suspension_reason": "Optional — only present if account_status is suspended"
}

After editing users.json, restart the server — the file is loaded once at startup.

Mock Users (for testing)

Email	Plan	Status
sarah.chen@example.com	Premium	Active
james.patel@example.com	Free	Active
maria.gonzalez@example.com	Premium	Active
derek.kim@example.com	Free	Suspended
linda.wu@example.com	Premium	Active
tom.nguyen@example.com	Free	Active
aisha.johnson@example.com	Premium	Active
carlos.rivera@example.com	Free	Active

Requirements

fastmcp>=2.0.0
mcp>=1.0.0
python-dotenv>=1.0.0

License

MIT — free to use, modify, and extend.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

CraloOAuth
ai.cralo
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Agent Orchestration Developer Tools
1
Unified.to MCP Server C
to.unified.docs
Unified MCP Server is a remote MCP connector for AI agents and vertical AI products that provides access to 22,000+ authorized SaaS tools across 400+ integrations and 24 categories directly inside LLMs (Claude, GPT, Gemini, Cohere). Tools operate only on explicitly authorized customer connections, enabling agents to safely read and write against live third-party systems.
App Automation Agent Orchestration Developer Tools
252
pocket-agent-mcp A
io.github.cwhited26
Pocket Agent (aipocketagent.com) MCP server — read tools for personas, apps, and product info.
Agent Orchestration AI & Machine Learning
411
Agentic Shelf A
ai.agenticshelf
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
E-commerce & Retail Search
2

Related MCP Servers

Coffee Company MCP Server
Customer Data Platforms E-commerce & Retail App Automation
sawzhang
F
license
B
quality
D
maintenance
An MCP adapter that maps Coffee Company B2B HTTP APIs to MCP tools, allowing AI agents to query member information, benefits, coupons, and payment statuses. It enables seamless integration for AI assistants to manage coffee-related customer assets and loyalty details through natural language.
Updated 4 months ago (2026-05-12 11:42 UTC)
10
1
-
Ticket Support MCP Server
dsoziev1
F
license
Not graded
quality
F
maintenance
Enables retrieval of support tickets and user data from a JSON store or ServiceNow via MCP tools, providing context for AI-powered support responses.
Updated 2 months ago (2026-07-17 17:31 UTC)
-
NeuralVerge MCP Serverofficial
Research & Data Agent Orchestration AI & Machine Learning
neuralverge
A
license
A
quality
C
maintenance
Exposes NeuralVerge's full API as MCP tools for AI research, extraction, agents, and data enrichment (LinkedIn, email, phone), enabling any MCP-compatible client to call them directly.
Updated a month ago (2026-08-13 13:47 UTC)
30
16
MIT
MCP Customer Support AI
Customer Support E-commerce & Retail
ashwani-yadav83602
F
license
Not graded
quality
C
maintenance
Enables an AI to perform customer support workflows by looking up customers, retrieving orders, and creating support tickets through MCP tools.
Updated 19 days ago (2026-08-23 09:06 UTC)
5
-