{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
  "name": "io.nextlevelbuilder/directory",
  "version": "0.2.1",
  "title": "Next Level Builders Directory",
  "description": "Use Next Level Builders from any MCP client: search, read and submit directory products, check rankings and traffic, manage API keys, blog posts, Builder League progress and membership onboarding; platform operators also run NLB Live and manage orders, accounts, entitlements and listings.",
  "websiteUrl": "https://nextlevelbuilder.io/mcp-server",
  "repository": {
    "url": "https://github.com/nextlevelbuilder/nlb-web-v2",
    "source": "github",
    "subfolder": "packages/mcp"
  },
  "icons": [
    {
      "src": "https://nextlevelbuilder.io/icon-512.png",
      "mimeType": "image/png",
      "sizes": [
        "512x512"
      ]
    },
    {
      "src": "https://nextlevelbuilder.io/icon.svg",
      "mimeType": "image/svg+xml",
      "sizes": [
        "any"
      ]
    }
  ],
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://nextlevelbuilder.io/mcp",
      "supportedProtocolVersions": [
        "2026-07-28",
        "2025-11-25",
        "2025-06-18",
        "2025-03-26",
        "2024-11-05"
      ]
    }
  ],
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@nextlevelbuilder/mcp",
      "version": "0.2.1",
      "transport": {
        "type": "stdio"
      }
    }
  ],
  "_meta": {
    "io.nextlevelbuilder/discovery": {
      "serverName": "nlb-directory-mcp",
      "authorization": {
        "protectedResourceMetadata": "https://nextlevelbuilder.io/.well-known/oauth-protected-resource/mcp",
        "authorizationServer": "https://nextlevelbuilder.io/api/auth",
        "scopesSupported": [
          "mcp:read",
          "mcp:write",
          "mcp:keys",
          "mcp:operator",
          "offline_access"
        ],
        "apiKeyHeader": "Authorization: Bearer nlb_live_…"
      },
      "openapi": "https://nextlevelbuilder.io/api/openapi.json",
      "apiDocs": "https://nextlevelbuilder.io/api-docs",
      "llms": "https://nextlevelbuilder.io/llms.txt",
      "llmsFull": "https://nextlevelbuilder.io/llms-full.txt",
      "builderLeague": {
        "name": "NLB Builder League",
        "description": "Builder progress for NLB members: evidence of shipping and contributing, RP, ranks, missions, badges, rewards, rankings and the Year in Review.",
        "status": "pilot",
        "flag": "BUILDER_LEAGUE_ENABLED",
        "availability": "Pilot only: while BUILDER_LEAGUE_ENABLED is off, every /api/v1/builder-* route answers 404 except for admins and pilot members, and the MCP tools report that Builder League is not enabled on this environment.",
        "routes": "/api/v1/builder-*",
        "openapi": "https://nextlevelbuilder.io/api/openapi.json",
        "auth": {
          "member": "Browser session, an API key (Authorization: Bearer nlb_live_… or x-api-key) or MCP delegation: mcp:read for reads, mcp:write for writes.",
          "admin": "/api/v1/builder-admin/* needs a signed-in admin session; agents are refused, and API keys are refused except the scoped automation keys below on their own routes.",
          "automationScopes": {
            "builder:render": "Admin-minted API key for the Year in Review render worker; accepted only on /api/v1/builder-admin/render-jobs/**.",
            "builder:ingest": "Admin-minted API key for the Discord bot; accepted only on /api/v1/builder-admin/ingest/discord."
          }
        },
        "agentPolicy": {
          "may": [
            "Read the connected member's own Builder League profile, journey, evidence, projects, missions, badges, rewards and Year in Review.",
            "Submit, edit, withdraw or appeal the member's own evidence (always stored as self_reported and submitted for human review) and create the member's projects.",
            "Join a season, save the member's Time Capsule, request a Year in Review video and revoke the member's own share links.",
            "Read Builder League rankings.",
            "Export the connected member's own league data (GET /api/v1/builder-me/export), which includes their private evidence and notes."
          ],
          "mayNot": [
            "Approve, verify, reject or moderate evidence.",
            "Award or claim RP, badges or rewards, or confirm peer help.",
            "Read another member's private history or change privacy settings.",
            "Call /api/v1/builder-admin/* routes, which need a signed-in admin session (MCP delegation is refused); the only exceptions are the render and ingest routes for admin-minted automation keys listed under automationScopes.",
            "Delete the member's league data: POST /api/v1/builder-me/delete needs a signed-in browser session."
          ]
        },
        "tools": [
          "builder_get_access",
          "builder_get_me",
          "builder_list_projects",
          "builder_list_evidence",
          "builder_get_evidence",
          "builder_get_journey",
          "builder_list_missions",
          "builder_list_badges",
          "builder_get_seasons",
          "builder_get_rankings",
          "builder_list_rewards",
          "builder_get_time_capsule",
          "builder_get_passport",
          "builder_get_year",
          "builder_list_share_links",
          "builder_list_year_videos",
          "builder_get_community_wrapped",
          "builder_create_project",
          "builder_submit_evidence",
          "builder_update_evidence",
          "builder_withdraw_evidence",
          "builder_appeal_evidence",
          "builder_join_season",
          "builder_save_time_capsule",
          "builder_request_year_video",
          "builder_revoke_share_link",
          "builder_admin_list_queue",
          "builder_admin_backfill_preview"
        ]
      },
      "liveOperator": {
        "scope": "mcp:operator",
        "audience": "Platform operators: the scope needs an unrevoked operator grant and the Live tools need live:manage. Members never receive the scope; API keys are refused.",
        "approvals": "Ticket refunds, event cancellations and winner overrides need an approval decided by a second operator.",
        "audit": "Every call, allowed or denied, is written to the operator audit trail.",
        "tools": [
          "live_admin_list_events",
          "live_admin_get_event",
          "live_admin_list_event_tickets",
          "live_admin_list_topic_groups",
          "live_admin_list_topics",
          "live_admin_list_rounds",
          "live_admin_list_approvals",
          "live_admin_get_approval",
          "live_admin_list_audit",
          "live_admin_get_metrics",
          "live_admin_create_topic_group",
          "live_admin_update_topic_group",
          "live_admin_archive_topic_group",
          "live_admin_create_topic",
          "live_admin_update_topic",
          "live_admin_archive_topic",
          "live_admin_create_round",
          "live_admin_finalize_round",
          "live_admin_override_round_winner",
          "live_admin_create_event",
          "live_admin_update_event",
          "live_admin_set_event_capacity",
          "live_admin_transition_event",
          "live_admin_create_event_product",
          "live_admin_open_event_sales",
          "live_admin_create_event_meeting",
          "live_admin_cancel_event",
          "live_admin_refund_ticket",
          "live_admin_request_approval",
          "live_admin_decide_approval",
          "live_admin_run_sweeps"
        ]
      },
      "platformOperator": {
        "scope": "mcp:operator",
        "audience": "Platform operators: each tool also needs the grant of its domain (commerce:manage, users:manage, membership:manage or directory:manage), checked by the web on every call. Members never receive the scope; API keys are refused.",
        "approvals": "Order refunds need an approval for the exact order, reason and amount, decided by a second operator and usable once.",
        "audit": "Every call, allowed or denied, is written to the operator audit trail.",
        "tools": [
          "operator_commerce_list_orders",
          "operator_commerce_get_order",
          "operator_commerce_list_subscriptions",
          "operator_commerce_get_subscription",
          "operator_commerce_cancel_subscription",
          "operator_commerce_resume_subscription",
          "operator_commerce_list_customers",
          "operator_commerce_get_customer",
          "operator_commerce_list_webhook_failures",
          "operator_commerce_refund_order",
          "operator_users_list",
          "operator_users_get",
          "operator_users_list_orgs",
          "operator_users_get_org",
          "operator_membership_list_entitlements",
          "operator_membership_get_user_access",
          "operator_directory_list_products",
          "operator_directory_get_product",
          "operator_directory_list_moderation",
          "operator_approvals_list",
          "operator_approvals_get",
          "operator_approvals_request",
          "operator_approvals_decide"
        ]
      }
    }
  }
}