Skip to main content
Glama
Zain Ahmed Platform MCP Server

Zain Ahmed Platform MCP Server

Zain Ahmed Platform MCP Server

Official Model Context Protocol (MCP) server for Zain Ahmed: Senior Software & Platform Engineer. Enterprise AI & cloud infrastructure strategy, multi-cloud SRE, Agentic AI & MLOps architectures, and FinOps advisory.

Smithery Registry npm version CI Status License: MIT MCP Protocol Live Platform

This server connects autonomous AI agents (Claude Code, Cursor, Windsurf, Roo Code, Antigravity) directly to Zain Ahmed's engineering platform. It enables agents to inspect verified multi-cloud architectures, query Enterprise AI & MLOps patterns, 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

Client Configuration Matrix

Client / Environment

Support Type

Quick Configuration Command or File

Antigravity (CLI / 2.0 / IDE)

Stdio & SSE

agy mcp add or .agents/mcp.json

Claude Code

Stdio & HTTP

claude mcp add zainahmed -- ...

Claude Desktop

Stdio

claude_desktop_config.json

Cursor IDE

Stdio & SSE

.cursor/mcp.json

Codex (CLI & IDE)

Stdio & HTTP

codex mcp add or ~/.codex/config.toml

Warp Terminal

Stdio & HTTP

Settings > Agents > MCP or ~/.warp/mcp.json

Factory Droid

Stdio & HTTP

droid mcp add or ~/.factory/mcp.json

Superset (superset.sh)

Stdio & HTTP

.mcp.json workspace manifest

Remote Streamable HTTP

Universal SSE

https://zainahmed.net/mcp


Antigravity (CLI, Antigravity 2.0, & Antigravity IDE)

Workspace Configuration (Project-Scoped)

Create or update .agents/mcp.json at the root of your workspace:

{
  "mcpServers": {
    "zainahmed": {
      "command": "npx",
      "args": ["-y", "@zainahmed.net/sdk", "mcp"]
    },
    "zainahmed-remote": {
      "serverUrl": "https://zainahmed.net/mcp"
    }
  }
}
Global Configuration (Machine-Scoped)

Add to your global configuration file:

  • macOS / Linux: ~/.gemini/config/mcp_config.json

  • Windows: %USERPROFILE%\.gemini\config\mcp_config.json

{
  "mcpServers": {
    "zainahmed": {
      "command": "npx",
      "args": ["-y", "@zainahmed.net/sdk", "mcp"]
    }
  }
}
Antigravity CLI (agy) Quick Command
# Local stdio runner
agy mcp add zainahmed -- npx -y @zainahmed.net/sdk mcp

# Or hosted remote endpoint
agy mcp add zainahmed --url https://zainahmed.net/mcp

Claude Code

# Local stdio runner
claude mcp add zainahmed -- npx -y @zainahmed.net/sdk mcp

# Or hosted remote streamable HTTP
claude mcp add --transport http zainahmed https://zainahmed.net/mcp
Project Configuration (.mcp.json)

Add to your project root .mcp.json:

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

Verify connection in your session by running /mcp or claude mcp list.


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

  • Linux: ~/.config/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 (Cursor Settings > Features > MCP):

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

For hosted remote endpoints without local Node.js:

{
  "mcpServers": {
    "zainahmed": {
      "url": "https://zainahmed.net/mcp"
    }
  }
}

Codex (OpenAI Codex CLI & IDE)

CLI One-Liner
# Local stdio runner
codex mcp add zainahmed -- npx -y @zainahmed.net/sdk mcp

# Or hosted remote endpoint
codex mcp add zainahmed --url https://zainahmed.net/mcp
Configuration File (~/.codex/config.toml or workspace .codex/config.toml)

Add to your TOML configuration:

[mcp_servers.zainahmed]
command = "npx"
args = ["-y", "@zainahmed.net/sdk", "mcp"]

# Or hosted remote endpoint:
# [mcp_servers.zainahmed]
# url = "https://zainahmed.net/mcp"

Verify connection by running codex mcp list.


Warp Terminal

  1. Open Warp Settings (Cmd + , on macOS, Ctrl + , on Linux).

  2. Navigate to Agents > MCP servers and click Add.

  3. Fill in:

    • Name: zainahmed

    • Command: npx

    • Args: -y @zainahmed.net/sdk mcp

Configuration File (~/.warp/mcp.json or .warp/.mcp.json)
{
  "mcpServers": {
    "zainahmed": {
      "command": "npx",
      "args": ["-y", "@zainahmed.net/sdk", "mcp"]
    }
  }
}
Hosted Remote Endpoint
{
  "mcpServers": {
    "zainahmed": {
      "url": "https://zainahmed.net/mcp"
    }
  }
}

Factory Droid

Interactive Terminal

Type /mcp in your Droid session and select Add Custom Server.

CLI One-Liner
droid mcp add zainahmed https://zainahmed.net/mcp --type http
Configuration File (~/.factory/mcp.json)
{
  "mcpServers": {
    "zainahmed": {
      "type": "http",
      "url": "https://zainahmed.net/mcp"
    }
  }
}

Superset (superset.sh)

Superset is the multi-agent AI terminal and workspace. Add .mcp.json to your workspace root to make Zain Ahmed platform tools available across all terminal tabs and background agent loops:

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

Or run via local stdio:

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

Remote Streamable HTTP (Universal / Zero Node.js Required)

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

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

Available Tools

Tool Name

Mode

Arguments

Description

get_profile

Read

section (optional)

Returns verified platform profile, certifications, and contacts.

get_skills

Read

category (optional)

Returns competency matrices across cloud, containers, devsecops, and mlops.

get_certifications

Read

None

Returns verified credentials across AWS, Azure, GCP, and OCI.

get_projects

Read

category (optional)

Lists enterprise case studies, tech stacks, and quantifiable business outcomes.

get_articles

Read

tag (optional)

Lists technical publications, SRE blueprints, and architectural RFCs.

search_knowledge_base

Read

query (required)

Full-text semantic search across case studies and architecture documentation.

get_services

Read

tier (optional)

Returns advisory consulting retainers, fractional scopes, and service tiers.

calculate_finops_roi

Read

monthlyCloudSpend (req)

Computes projected 30% to 40% cost reductions from Karpenter, spot, and Graviton.

submit_contact

Write

name, email, message

Dispatches an encrypted engineering inquiry directly to Zain Ahmed.

search_docs

Read

query (required)

Searches system runbooks, API guides, and versioning specifications.

get_documentation_page

Read

slug (required)

Retrieves full markdown documentation for any platform topic or API guide.


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:

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


License

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


Last reviewed: September 2026

Available Tools

11 tools
calculate_finops_roiA
Read-only

Calculate estimated cloud cost savings and ROI from Karpenter container bin-packing, spot orchestration, and Graviton migration.

Inputs: monthlyCloudSpend (required), cloudProvider.

get_articlesB
Read-only

List in-depth architectural publications, SRE blueprints, and systems engineering deep dives.

Inputs: tag.

get_certificationsA
Read-only

Retrieve verified 5x multi-cloud credentials, badge verification URLs, and credential IDs across AWS, Azure, GCP, and OCI.

Inputs: no named parameters.

get_documentation_pageA
Read-only

Retrieve full documentation content and guides for a specific platform topic.

Inputs: slug (required).

get_profileB
Read-only

Retrieve Zain Ahmed's verified professional profile, 5x multi-cloud credentials (AWS, Azure, GCP, OCI, HashiCorp), location, philosophy, and competencies.

Inputs: section.

get_projectsA
Read-only

List verified enterprise cloud architecture case studies, client domains, tech stacks, and quantifiable business outcomes.

Inputs: category.

get_servicesA
Read-only

Retrieve platform engineering advisory retainers, fractional leadership tiers, deliverables, commitments, and transparent rates.

Inputs: tier.

get_skillsA
Read-only

Retrieve complete categorised multi-cloud, Kubernetes, DevSecOps, IaC, and MLOps competency matrices with production seniority ratings.

Inputs: category.

search_docsA
Read-only

Full-text search across all documentation, architectural blueprints, API guides, and system runbooks.

Inputs: query (required).

search_knowledge_baseA
Read-only

Full-text search across all case studies, architecture articles, developer documentation, and platform capabilities.

Inputs: query (required).

submit_contactA

Dispatch an encrypted engineering inquiry or consultation request directly to Zain Ahmed with tracking reference ID.

Inputs: name (required), email (required), message (required), company, +1 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 11 tools

    Disambiguation3/5

    Most tools are clearly distinct by resource type, but search_knowledge_base and search_docs have heavily overlapping scopes, and get_articles/get_documentation_page could be confused. Descriptions help resolve most ambiguities, but the search tool redundancy creates real selection risk.

    Naming Consistency4/5

    The naming pattern is largely consistent with get_* for retrieval, search_* for search, and single action verbs for calculate/submit. Minor inconsistencies like search_docs vs search_knowledge_base and calculate_finops_roi not following a common verb prefix are small deviations from an otherwise clear scheme.

    Tool Count4/5

    Eleven tools is reasonable for a personal platform covering profile, portfolio, services, documentation, search, ROI calculation, and contact. The count is not excessive, though the two overlapping search tools could be consolidated to make the surface tighter.

    Completeness4/5

    The server covers the main informational and engagement needs: profile, skills, certifications, projects, articles, services, documentation, ROI estimation, and contact. Minor gaps exist, such as no dedicated article detail retrieval action or project detail action, but agents can likely work around these via search and documentation tools.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to query multi-cloud costs, inventory, waste, and commitments across AWS, GCP, Cloudflare, and OVH through read-only MCP tools.
      Apache 2.0
    • A
      license
      A
      quality
      A
      maintenance
      Enables MCP-compatible AI clients to retrieve FinOps-aligned knowledge and runbooks on demand, covering cloud cost optimization across AWS, Azure, GCP, and OCI, AI inference economics, Kubernetes, data platforms, allocation, chargeback, anomaly management, and waste detection.
      7
      75
      CC BY-SA 4.0