⚙️ MCP Server Operations · Complete Guide

MCP Server Ops:
The Complete Operations Guide

Everything you need to deploy, test, connect a database, take real payments, and secure a production FastMCP server — in one place, with complete runnable code.

5 Live Guides
FastMCP + FastAPI + Vercel
0 Handwaving
$0 To Get Started

From "hello world" to production-grade MCP server

The Model Context Protocol opened a new surface for builders — but most tutorials stop at "npm install and it works on localhost." The hard part is everything after: databases, payments, auth, testing, and getting indexed by agents that actually use your server.

Every guide in this series is built from primary sources — the MCP spec, FastMCP docs, Stripe API reference, asyncpg source, and Vercel's own documentation. No secondhand summaries. Complete runnable code that you can paste and deploy.

The series is structured in three tiers: Core Operations (deploy, test, database, payments, auth), Distribution & Growth (directories, llms.txt, monitoring), and Enterprise Patterns (multi-tenant, Shopify integration, advanced billing).

🧑‍💻

Solo developers building their first MCP server

Start with Spoke 1 (Deploy & List) and work through in order. Each guide builds on the previous one.

🏗️

Developers who deployed but got stuck on production

Jump to the guide you need — database pooling, Stripe webhooks, JWT auth. Each spoke is self-contained.

💰

Founders turning a FastMCP prototype into a product

Spokes 4 (Stripe) and 5 (Auth) are where prototype becomes billable. That's the commercial pivot point.

🤖

Teams building agent-native commerce infrastructure

The Agent Mall series and MCP Server Ops overlap here — read both if you're building for AI agents to transact through.

Tier 1
Core Operations — 5 Guides, All Live

The foundation every production MCP server needs: deploy, test, connect data, take payments, lock down auth. Work through these in order on your first build.

Spoke 01
🚀

Deploy a FastMCP Server & Get Listed in the Registry

FastMCP + FastAPI on Vercel from scratch. Streamable HTTP transport, stateless_http=True, vercel.json routing, and submitting to PulseMCP and the official MCP Registry.

FastMCP Vercel PulseMCP mcp-remote
Spoke 02
🔬

Test Your MCP Server: Inspector, Claude Desktop & Vercel Logs

MCP Inspector v0.21.2, Claude Desktop wiring with both stdio and mcp-remote config, a full Python test script, and reading Vercel function logs for 5 common error patterns.

MCP Inspector Claude Desktop Vercel Logs mcp-remote@0.1.38
Spoke 03
🗄️

Database Connection: asyncpg, Supabase & Postgres on Vercel

Why blocking DB calls break async FastMCP tools. Complete server code for asyncpg, Supabase async client, and SQLAlchemy 2.x. Connection pooling for serverless, Vercel Postgres deprecation, and the Neon migration path.

asyncpg Supabase SQLAlchemy 2.x lifespan
Spoke 04
💳

Wire Stripe Checkout: Payments, Webhooks & Test Cards

Replace the fake URL with a real Stripe Checkout Session. stripe==15.1.0, Session.create with inline pricing, 9 test cards, the full webhook handler (including checkout.session.async_payment_succeeded), and the official Stripe MCP server at mcp.stripe.com.

stripe==15.1.0 Webhooks Test Cards mcp.stripe.com
Spoke 05
🔐

MCP Server Authentication: API Keys, JWT, and OAuth 2.1

REQUIRE_AUTH=false threat model, FlexAuthMiddleware (15 lines, no infrastructure), JWTVerifier with RS256/HS256/JWKS, per-tool require_scopes, CORS lockdown with expose_headers, and slowapi rate limiting.

JWTVerifier require_scopes CORS slowapi
Tier 2
Distribution & Growth — Coming Soon

Once your server is live and secure, these guides cover getting it discovered, monitored, and growing — from directory listings to agent-readable metadata files.

Spoke 06
📋

Get Listed: Smithery, PulseMCP & MCP Registry Submission

The top directories that AI agent builders search. Submission formats, expedite paths, and what makes a listing rank well. Free traffic from 576,000+ MCP client searches per month.

SmitheryPulseMCPglama.ai
Spoke 07
📄

agents.txt & llms.txt: Machine-Readable Server Metadata

How AI agents and crawlers discover what your server does. The agents.txt standard, llms.txt format, OpenAPI spec exposure, and what Anthropic's crawler actually reads.

agents.txtllms.txtOpenAPI
Spoke 08
📈

Monitoring & Uptime: Vercel Analytics, Sentry & Alerts

Know when your MCP server is down before your users do. Vercel function metrics, error tracking with Sentry, uptime monitoring, and alerting for cold-start spikes.

SentryVercel AnalyticsUptime
Spoke 09
🔧

Multi-Tool Servers: Organizing & Versioning a Large Tool Set

When your MCP server has 20+ tools. Tool namespacing, versioning strategies, splitting across modules, and keeping Claude's context window manageable with a large tool surface.

FastMCP RoutersTool Namespacing
Spoke 10
💻

Claude Desktop Power User: Hooks, Custom Prompts & Workflows

Get more from Claude Desktop with your MCP server. Custom system prompts, tool call hooks, keyboard shortcuts, and building repeatable agent workflows over your server's tools.

Claude DesktopHooksWorkflows
Tier 3
Enterprise Patterns — Planned

Advanced patterns for multi-tenant deployments, Shopify integration, and metered billing — when your server outgrows the solo-operator stage.

Spoke 11
🛍️

Shopify MCP Wrapper: Expose Your Store to AI Agents

Wrap Shopify's Admin API in a FastMCP server. Product search, inventory, order creation, and discount codes — exposed as MCP tools that Claude can use to shop on a user's behalf.

Shopify APIFastMCP
Spoke 12
🏢

Multi-Tenant SaaS: Per-Customer MCP Servers on One Deployment

Serve multiple customers from a single Vercel deployment using JWT-based tenant isolation. Per-tenant tool visibility, row-level security, and billing per customer.

Multi-tenantJWTRLS
Spoke 13

Metered Billing: Charge Per Tool Call with Stripe Metered

Move from flat-rate to usage-based pricing. Count tool calls per JWT identity, batch usage records to Stripe Metered Billing, and surface usage to customers with a simple dashboard.

Stripe MeteredUsage Records

What you ship after Tier 1

Work through all five core guides and you'll have a production-ready MCP server with:

1

Live Vercel deployment

Streamable HTTP transport, vercel.json routing, cold-start optimized, indexed on PulseMCP.

2

Tested end-to-end

MCP Inspector verified, Claude Desktop connected, Python test suite, and Vercel logs readable.

3

Real database

Async connection pool (asyncpg or Supabase), lifespan-managed, statement_cache_size=0 set correctly.

4

Live Stripe payments

initiate_checkout returning real checkout.stripe.com URLs, webhook handler fulfilling orders reliably.

5

Locked-down auth

FlexAuthMiddleware or JWTVerifier, per-tool require_scopes, CORS set correctly, slowapi rate limiting.

How these guides are written

A few things you will not find here: tutorials that stop at localhost, "exercise for the reader" gaps, or advice that contradicts the official docs.

📌

Pinned versions, always

Every install command pins a specific version. stripe==15.1.0, not stripe. Unpinned dependencies are how tutorials rot.

Complete runnable code

Code blocks are complete files you can paste and run, not fragments with implied imports and missing boilerplate.

⚠️

Deprecations called out

Vercel Postgres sunsetted December 2024. mcp-remote 0.0.5–0.1.15 has CVE-2025-6514. You'll know before you ship.

📖

Primary sources only

Built from the MCP spec, FastMCP docs, Stripe API reference, and asyncpg source — not recycled Stack Overflow answers.

🔒

Security defaults

REQUIRE_AUTH=false is never recommended for a public server. Every guide starts from the assumption that real users are paying real money.

🧪

Testability built in

Every guide includes a verification step — MCP Inspector commands, test cards, curl examples — so you know it works before you ship.

Get Tier 2 & 3 Guides When They Ship

New guides on directory listings, agents.txt, monitoring, multi-tenant patterns, and metered billing — delivered to your inbox when they're ready.

✓ You're in — watch your inbox.