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 Related Servers Score Discussions

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: apollo-io-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

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

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 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 3 months ago (2026-05-12 11:42 UTC)
10
1
apollo-io-mcp-server
edwardchoh
F
license
B
quality
D
maintenance
Exposes Apollo.io API functionalities as MCP tools for people and organization enrichment, search, and job postings. Enables natural language interaction with Apollo.io data.
Updated a year ago (2025-04-11 23:20 UTC)
5
16
leads-mcp
Search Customer Data Platforms
AtomicIntuition
A
license
A
quality
D
maintenance
Lead generation MCP server for AI agents. Find emails, verify contacts, enrich profiles, and search prospects using Hunter.io, Apollo.io, and Abstract API.
Updated 6 months ago (2026-03-03 03:48 UTC)
8
8
MIT
Ticket Support MCP Server
dsoziev1
F
license
-
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 a month ago (2026-07-17 17:31 UTC)

View all related MCP servers

Related MCP Connectors

pocket-agent-mcp
Pocket Agent (aipocketagent.com) MCP server — read tools for personas, apps, and product info.
GTM API: LinkedIn MCP Server
Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.
outris-identity-mcp
Identity resolution MCP server for phone/email lookups across 31+ services. Global + India coverage.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/23viv/nimbus_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server