Quickstart

Deploy your first MCP server in under 5 minutes. This walkthrough uses TypeScript, but every step has a Python equivalent — swap --template ts for --template py.

Prerequisites

• Node.js 20 or later, or Python 3.11+ if you prefer.
• A Cognoverge account — sign up free at cognoverge.com/signup.
• An MCP-capable client — Claude Desktop, Cursor, or Windsurf.

1. Install the CLI

The Cognoverge CLI wraps deploy, logs, auth, and monetize into one binary. Install it globally, or run it via npx without installing.

# Install globally
npm install -g @cognoverge/cli

# Or run without installing
npx @cognoverge/cli --help

2. Scaffold a server

The init command creates a directory with a starter server that exposes two tools.

cognoverge init my-first-mcp --template ts
cd my-first-mcp

Open the generated src/server.ts:

import { createMcpServer } from "@cognoverge/mcp";

export default createMcpServer({
  name: "my-first-mcp",
  tools: {
    echo: {
      description: "Return whatever you send",
      input: { text: "string" },
      handler: async ({ text }) => ({ echoed: text }),
    },
    now: {
      description: "Return the current UTC time",
      input: {},
      handler: async () => ({ time: new Date().toISOString() }),
    },
  },
});

3. Deploy

One command bundles, provisions HTTPS, wires OAuth, and pushes to 22 edge regions.

cognoverge deploy

✓ Detected src/server.ts
✓ Bundled 4.1 kB
✓ Provisioned https://my-first-mcp.you.cognoverge.dev
✓ OAuth: Google, GitHub, magic-link
✓ Rate limits, audit log, p95 metrics live
✓ Live in 21.8s

Custom domain (optional)

Add your own domain from the dashboard, then redeploy. TLS auto-renews.

cognoverge domain add mcp.acme.com

4. Add to Claude Desktop

Cognoverge writes the correct config into your client for you. Pick your client with --client=claude|cursor|windsurf|cline.

cognoverge add my-first-mcp --client=claude

Restart Claude Desktop. In a new chat, click the paperclip and confirm the OAuth prompt to Google or GitHub — you'll see my-first-mcp appear as an available tool.

5. Watch it work

Stream logs in your terminal or open the dashboard.

cognoverge logs --tail

21:04:12  tools/call  my-first-mcp · echo   Claude · sarah@   42ms  200
21:04:18  tools/call  my-first-mcp · now    Claude · sarah@   18ms  200
21:04:25  tools/list  my-first-mcp          Claude · sarah@    9ms  200

Or open app.cognoverge.com for the full dashboard: calls per hour, p50/p95/p99 latency, per-tool breakdown, and every OAuth identity that's called your server.