8genCMCP
Field Manual · v2.0

Connect to the channel

Everything an operator or client needs to put an AI agent on the 8genC MCP server. Budget about four minutes once your account is approved.

POSThttps://mcp.8genc.com/mcp Operational
01

Prerequisites

The hosted endpoint is protected. Before you can connect you need:

  • An approved 8genC account. Register at mcp.8genc.com/access, verify your email, and wait for an admin to approve you and assign your track.
  • An MCP-capable client. Claude, Cursor, or Windsurf — anything that speaks Streamable HTTP MCP.
  • A credential. Either browser OAuth at connect time, or a personal access token minted in the portal.

Running locally over stdio? Platform discovery and the core skill tools work with zero credentials. Only skill_search and skill_sync need a ZeroDB account.

02

Authentication

Every request to POST /mcp must carry a valid credential for an approved account. Pick whichever method your client supports — both are gated on account status approved.

OAuth 2.1 — browser sign-in

The server is its own authorization server (RFC 9728 metadata + PKCE). Clients that support MCP OAuth open a browser, you sign in and consent, and the client receives a scoped token automatically.

Recommended for Claude

Personal access token

Create a token in the portal and pass it as a Bearer header. Best for headless clients and CI. Revoke it any time from /access.

Format · 8genc_pat_…

Token configuration

mcp.json · Bearer header 
{
  "mcpServers": {
    "prd-generator": {
      "type": "http",
      "url": "https://mcp.8genc.com/mcp",
      "headers": {
        "Authorization": "Bearer 8genc_pat_…"
      }
    }
  }
}
03

Configure your client

Add the server to your MCP client config. OAuth-capable clients can omit the headers block entirely and sign in at connect.

claude_desktop_config.json 
// OAuth: omit headers — Claude opens a browser to sign in
{
  "mcpServers": {
    "prd-generator": {
      "type": "http",
      "url": "https://mcp.8genc.com/mcp"
    }
  }
}
04

Verify the connection

Restart your client and confirm the server registered. You should see 8 tools and a set of skill prompts.

prd-generator · connected
› List the tools on prd-generator

✓ connected  mcp.8genc.com/mcp   (38ms)

  platform   prd_list_services · prd_get_api_catalog · prd_suggest_stack
  skills     skill_list · skill_get · skill_get_reference · skill_search · skill_sync

✓ 8 tools ready  ·  prompts loaded from the8genc/ai-8gent-skills

Seeing 401 Unauthorized? Your account is likely still pending. Check your approval status in the portal — the channel stays closed until an admin approves you.

05

First commands

You're on the channel. Start with discovery, then load a skill.

Discover the platform Use prd_suggest_stack for "an agent that remembers user preferences and stores files"
Find a skill skill_search "turn a SOP into an automated system"
Load a playbook skill_get prd-generator
Browse the full catalog
06

Security model

The portal at /access has two personas and a strict approval gate.

Users

Register, verify email, manage profile and password, create & revoke personal access tokens, and see approval status plus connection instructions.

Admins

Approve or reject pending accounts, block / unblock, reset passwords, assign tracks, and elevate verified users to admin.

Default-closed

New accounts are pending until approved. The first admin is seeded and must rotate its password on first login. Sessions are JWT-backed; tokens are revocable.