Zain Ahmed Platform MCP Server

Official Model Context Protocol (MCP) server for Zain Ahmed's verified multi-cloud production systems, SRE blueprints, 5x cloud credentials, and FinOps advisory.

This server connects autonomous AI agents (Claude Code, Cursor, Windsurf, Roo Code, Antigravity) directly to Zain Ahmed's cloud engineering platform. It enables agents to inspect verified cloud architectures, calculate projected FinOps cost savings, search technical runbooks, and dispatch encrypted consultation inquiries.

Prerequisites

• Node.js: >= 18.0.0

• MCP Client: Claude Desktop, Cursor IDE, Windsurf, Roo Code, Antigravity, or any JSON-RPC 2.0 compliant host

• Zero External Dependencies: Standalone stdio binary runs with pure Node.js built-ins

Related MCP server: ProofFlow MCP Server

Quickstart

1. 1-Click Installation via Smithery

Install automatically for your preferred AI client through Smithery:

Claude Desktop:

npx -y @smithery/cli install @zainahmed-net/mcp-server --client claude

Cursor IDE:

npx -y @smithery/cli install @zainahmed-net/mcp-server --client cursor

2. Manual Client Configuration

Claude Desktop

Add this configuration to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "zainahmed": {
      "command": "npx",
      "args": ["-y", "@zainahmed.net/sdk", "mcp"]
    }
  }
}

Or run the local repository binary directly:

{
  "mcpServers": {
    "zainahmed": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/bin/index.js"]
    }
  }
}

Cursor IDE

Add this to .cursor/mcp.json in your workspace or through Cursor Global Settings:

{
  "mcpServers": {
    "zainahmed": {
      "command": "npx",
      "args": ["-y", "@zainahmed.net/sdk", "mcp"]
    }
  }
}

Remote Streamable HTTP (No Node.js Required)

If your client supports remote HTTP/SSE transports, connect directly to the hosted endpoints:

{
  "mcpServers": {
    "zainahmed-operations": {
      "url": "https://zainahmed.net/mcp"
    },
    "zainahmed-docs": {
      "url": "https://zainahmed.net/mcp/docs"
    }
  }
}

Available Tools

Example Agent Prompts

Once configured, AI coding assistants can answer technical queries using live server data:

• "What multi-cloud certifications does Zain Ahmed hold, and what are their verification IDs?"

• "Calculate our estimated monthly cloud savings if our current AWS spend is $45,000/month."

• "Search Zain's knowledge base for production Karpenter nodepool and autoscaling patterns."

• "Retrieve the architectural case study on the multi-tenant Kubernetes platform migration."

• "Dispatch a message to Zain requesting an architectural review for our Terraform migration."

Interactive Zero-Mutation Sandbox

For non-mutating evaluations and test runs, point inquiries to the interactive sandbox:

• Web Console: https://zainahmed.net/sandbox

• API Endpoint: POST https://zainahmed.net/api/v1/sandbox/contact

Sandbox requests return authentic RFC 9457 responses with simulated reference IDs without triggering real-world emails or webhooks.

Local Development & Testing

1. Clone Repository

git clone https://github.com/thezaynahmed/mcp-server.git
cd mcp-server

2. Verify Syntax

node --check bin/index.js

3. Test MCP Handshake via Stdio

Send a standard JSON-RPC 2.0 initialization payload:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node bin/index.js

Repository Structure

.
├── .github/workflows/ci.yml   # GitHub Actions automated syntax and lint check
├── .well-known/agent-plugins/ # Mirror of agent-plugins.org manifest
├── bin/
│   └── index.js               # Standalone executable MCP stdio server
├── AGENTS.md                  # Comprehensive AI coding agent instructions
├── .cursorrules               # Cursor IDE rules for MCP integration
├── plugin.json                # Agent-plugins.org discovery manifest
├── smithery.yaml              # Smithery 1-click registry descriptor
├── package.json               # Package metadata and bin declaration
├── LICENSE                    # MIT License
└── README.md                  # Project documentation & integration guide

Related Resources

• Zain Ahmed Portfolio Platform

• Official TypeScript SDK on npm

• Official Python SDK on PyPI

• OpenAPI 3.1 REST Specification

• Agent Authentication Protocol

License

This project is licensed under the MIT License. See the LICENSE file for details.

Last reviewed: September 2026