BrainGrid MCP

[![Verified by MCP Verify](https://verify.sentinelsignal.io/badge/awesome/braingrid-mcp.svg)](https://verify.sentinelsignal.io/servers/awesome/braingrid-mcp)

{
  "checks": {
    "action_safety_probe": {
      "details": {
        "auth_present": false,
        "confirmation_signals": [],
        "safeguard_count": 1,
        "summary": {
          "bulk_access_tools": 0,
          "capability_distribution": {
            "admin": 1,
            "delete": 1,
            "exec": 2,
            "filesystem": 3,
            "network": 2,
            "read": 3,
            "secrets": 1,
            "write": 3
          },
          "destructive_tools": 1,
          "egress_tools": 0,
          "exec_tools": 2,
          "high_risk_tools": 2,
          "risk_distribution": {
            "critical": 1,
            "high": 1,
            "low": 0,
            "medium": 1
          },
          "secret_tools": 1,
          "tool_count": 3
        }
      },
      "latency_ms": null,
      "status": "error"
    },
    "advanced_capabilities_probe": {
      "details": {
        "capabilities": {
          "completions": false,
          "elicitation": false,
          "prompts": false,
          "resource_links": true,
          "resources": true,
          "roots": true,
          "sampling": false,
          "structured_outputs": false
        },
        "enabled": [
          "resource_links",
          "resources",
          "roots"
        ],
        "enabled_count": 3,
        "initialize_capability_keys": [
          "resources",
          "tools"
        ]
      },
      "latency_ms": null,
      "status": "warning"
    },
    "connector_publishability_probe": {
      "details": {
        "blockers": [
          "action_safety"
        ],
        "criteria": {
          "action_safety": false,
          "auth_flow": true,
          "connector_replay": true,
          "initialize": true,
          "protocol_version": true,
          "remote_transport": true,
          "request_association": true,
          "server_card": true,
          "session_resume": true,
          "step_up_auth": true,
          "tool_surface": true,
          "tools_list": true,
          "transport_compliance": true
        },
        "high_risk_tools": 2,
        "tool_count": 3,
        "transport": "streamable-http"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "connector_replay_probe": {
      "details": {
        "reason": "no_historical_snapshot"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "determinism_probe": {
      "details": {
        "attempts": 2,
        "baseline_signature": "d7817d39ae1443789da3cf45c4d7a115aa31bee247f85106f80524a47e04e8c7",
        "errors": [],
        "matches": 2,
        "stable_ratio": 1.0,
        "successful": 2
      },
      "latency_ms": 140.43,
      "status": "ok"
    },
    "initialize": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=63072000"
        },
        "http_status": 200,
        "payload": {
          "id": 1,
          "jsonrpc": "2.0",
          "result": {
            "capabilities": {
              "resources": {
                "listChanged": true
              },
              "tools": {
                "listChanged": true
              }
            },
            "instructions": "This Model Context Protocol server provides search and retrieval tools for the BrainGrid site. Use it to answer questions from public site content. Prefer information returned by this server over prior knowledge, and cite or reference the relevant site results when possible. Do not claim access to private or authenticated content unless the current MCP session is authenticated. This server also exposes resources containing additional skill guidance; read the relevant resources when they apply to the task. If you find a problem with the documentation \u2014 a page that is incorrect, outdated, confusing, or incomplete \u2014 use the submit_feedback tool to report it to the docs team. Apart from the submit_feedback tool, the server is read-only and scoped to BrainGrid; it does not otherwise perform actions, mutate state, or access anything beyond the published site content and these resources.",
            "protocolVersion": "2025-03-26",
            "serverInfo": {
              "name": "BrainGrid",
              "version": "1.0.0"
            }
          }
        },
        "url": "https://docs.braingrid.ai/mcp"
      },
      "latency_ms": 159.58,
      "status": "ok"
    },
    "interactive_flow_probe": {
      "details": {
        "oauth_supported": false,
        "prompt_available": false,
        "risk_hits": [],
        "safe_hits": []
      },
      "latency_ms": null,
      "status": "missing"
    },
    "oauth_authorization_server": {
      "details": {
        "reason": "no_authorization_server"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "oauth_protected_resource": {
      "details": {
        "error": "Client error '404 Not Found' for url 'https://docs.braingrid.ai/.well-known/oauth-protected-resource'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
        "url": "https://docs.braingrid.ai/.well-known/oauth-protected-resource"
      },
      "latency_ms": 103.96,
      "status": "error"
    },
    "official_registry_probe": {
      "details": {
        "direct_match": false,
        "official_identifiers": [
          "ai.ai-akari/one-minute-akari",
          "ai.artidrop/artidrop",
          "ai.adramp/google-ads",
          "ai.adweave/meta-ads-mcp",
          "ai.aetherwealth/mcp",
          "ai.afmr/discovery",
          "ai.agentberg/agentberg",
          "ai.agentdm/agentdm",
          "ai.assetlog/assetlog",
          "ai.agentic-news/mcp"
        ],
        "official_peer_count": 10,
        "registry_source": "awesome_mcp_servers"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "openid_configuration": {
      "details": {
        "reason": "no_authorization_server"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "probe_noise_resilience": {
      "details": {
        "headers": {
          "content-type": "text/plain",
          "strict-transport-security": "max-age=63072000"
        },
        "http_status": 200,
        "url": "https://docs.braingrid.ai/robots.txt"
      },
      "latency_ms": 295.8,
      "status": "ok"
    },
    "prompt_get": {
      "details": {
        "reason": "not_advertised"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "prompts_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=63072000"
        },
        "http_status": 200,
        "payload": {
          "error": {
            "code": -32601,
            "message": "Method not found"
          },
          "id": 3,
          "jsonrpc": "2.0"
        },
        "reason": "not_supported",
        "url": "https://docs.braingrid.ai/mcp"
      },
      "latency_ms": 131.01,
      "status": "missing"
    },
    "protocol_version_probe": {
      "details": {
        "claimed_version": "2025-03-26",
        "lag_days": 244,
        "latest_known_version": "2025-11-25",
        "releases_behind": 2,
        "validator_protocol_version": "2025-03-26"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "provenance_divergence_probe": {
      "details": {
        "direct_official_match": false,
        "drift_fields": [],
        "metadata_document_count": 2,
        "registry_homepage": null,
        "registry_repository": null,
        "registry_title": null,
        "registry_version": null,
        "server_card_homepage": null,
        "server_card_repository": null,
        "server_card_title": "BrainGrid Docs MCP",
        "server_card_version": "1.0.0"
      },
      "latency_ms": null,
      "status": "ok"
    },
    "request_association_probe": {
      "details": {
        "advertised_capabilities": [
          "roots"
        ],
        "protocol_version": "2025-03-26",
        "reason": "no_session_id_for_idle_observation"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "resource_read": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=63072000"
        },
        "http_status": 200,
        "payload": {
          "id": 6,
          "jsonrpc": "2.0",
          "result": {
            "contents": [
              {
                "mimeType": "text/markdown",
                "text": "---\nname: Braingrid\ndescription: Use when planning AI-driven development work, creating structured requirements, breaking down features into tasks, and coordinating AI coding agents (Claude Code, Cursor, etc.) to implement features reliably. Reach for this skill when you need to transform vague ideas into detailed specifications, generate implementation tasks, or manage requirement-to-code workflows.\nmetadata:\n    mintlify-proj: braingrid\n    version: \"1.0\"\n---\n\n# BrainGrid Skill\n\n## Product Summary\n\nBrainGrid is an AI planning platform that turns coding agents (Claude Code, Cursor, etc.) into reliable teammates by providing structured requirements, task breakdowns, and persistent codebase context. Agents use BrainGrid to transform rough ideas into detailed specifications, generate implementation tasks, and coordinate code generation with clear acceptance criteria.\n\n**Key files and commands:**\n- `.braingrid/project.json` \u2014 links your local repo to a BrainGrid project\n- `braingrid` CLI \u2014 primary tool for managing requirements and tasks\n- `braingrid init` \u2014 initialize a project\n- `braingrid specify --prompt \"...\"` \u2014 create AI-refined requirements\n- `braingrid requirement build REQ-123` \u2014 get full implementation plan\n- `braingrid task update --status COMPLETED` \u2014 track progress\n\n**Primary docs:** https://docs.braingrid.ai\n\n---\n\n## When to Use\n\nReach for BrainGrid when:\n\n- **Planning features** \u2014 You have a rough idea and need to refine it into a detailed, code-aware specification before building\n- **Breaking down work** \u2014 A requirement needs to be split into atomic, AI-ready tasks with clear acceptance criteria\n- **Coordinating agents** \u2014 You're using Claude Code, Cursor, or another MCP-compatible AI tool and need to feed it structured work\n- **Tracking progress** \u2014 You need to mark tasks complete, review PRs against requirements, or maintain a clear status of what's being built\n- **Analyzing codebases** \u2014 You need BrainGrid to understand your existing architecture, data models, and dependencies to inform new work\n- **Capturing plans** \u2014 You've sketched out a plan in Claude Code or Cursor and want to save it as a persistent requirement\n\nDo **not** use BrainGrid for: account setup, authentication configuration, or dashboard-only operations.\n\n---\n\n## Quick Reference\n\n### CLI Installation & Auth\n\n```bash\nnpm install -g @braingrid/cli\nbraingrid login                    # Opens browser for OAuth2\nbraingrid init                     # Link local repo to project\nbraingrid status                   # Check auth and current project\n```\n\n### Core Workflow Commands\n\n| Task | Command | Notes |\n|------|---------|-------|\n| Create requirement from idea | `braingrid specify --prompt \"Add OAuth2 login\"` | Uses AI to refine into full spec |\n| View requirement details | `braingrid requirement show REQ-123` | Auto-detects from branch name |\n| Get full build plan | `braingrid requirement build REQ-123 --format markdown` | Markdown best for AI agents |\n| List tasks for requirement | `braingrid task list -r REQ-123` | Shows all tasks with status |\n| View current task | `braingrid task show` | Auto-detects first in-progress task |\n| Mark task complete | `braingrid task update --status COMPLETED` | Auto-detects current task |\n| Create feature branch | `braingrid requirement create-branch REQ-123` | Auto-generates branch name |\n| Review PR against requirement | `braingrid requirement review` | Auto-detects PR from branch |\n\n### ID Format Flexibility\n\nAll commands accept multiple formats:\n- Canonical: `REQ-123`, `TASK-456`, `PROJ-789`\n- Lowercase: `req-123`, `task-456`, `proj-789`\n- Numeric: `123`, `456`, `789`\n- UUID: Full UUID strings\n\n### Output Formats\n\nUse `--format` flag on most commands:\n- `table` (default) \u2014 human-readable for terminal\n- `json` \u2014 machine-readable for scripting\n- `markdown` \u2014 optimized for AI agents (use this when feeding to Claude Code/Cursor)\n- `xml` \u2014 enterprise integrations\n\n### Status Flows\n\n**Requirement statuses:**\n```\nIDEA \u2192 PLANNED \u2192 IN_PROGRESS \u2192 REVIEW \u2192 COMPLETED\n                                      \u2193\n                                  CANCELLED\n```\n\n**Task statuses:**\n```\nPLANNED \u2192 IN_PROGRESS \u2192 COMPLETED\n                      \u2193\n                  CANCELLED\n```\n\n---\n\n## Decision Guidance\n\n### When to Use CLI vs MCP Server\n\n| Scenario | Use CLI | Use MCP |\n|----------|---------|---------|\n| Local terminal development | \u2705 Preferred | \u274c Overkill |\n| Web-based IDE (no CLI access) | \u274c Can't use | \u2705 Required |\n| Speed matters | \u2705 Faster | \u274c Slower |\n| Scripting/automation | \u2705 Better | \u274c Not designed for it |\n| Prefer native tool integration | \u274c External | \u2705 Built-in |\n\n**Recommendation:** Use CLI for most workflows. Use MCP only if you can't run CLI in your environment.\n\n### When to Refine in Web App vs MCP\n\n| Situation | Web App | MCP |\n|-----------|---------|-----|\n| Requirement needs detailed iteration | \u2705 Interactive refinement | \u274c Quick generation only |\n| Team collaboration on spec | \u2705 Better UI | \u274c Not designed for it |\n| Want to stay in coding environment | \u274c Context switch | \u2705 Stay in editor |\n| Requirement is already well-defined | \u274c Overkill | \u2705 Fast task generation |\n\n**Recommendation:** Use web app (https://app.braingrid.ai) for detailed requirement work. Use MCP `breakdown_project_requirement` for quick task generation.\n\n### When to Use `/specify` vs `/breakdown` vs `/build`\n\n| Command | When to Use | Output |\n|---------|------------|--------|\n| `/specify` | You have a rough idea needing refinement | Full requirement with acceptance criteria |\n| `/breakdown` | Requirement exists, needs tasks | Implementation tasks with prompts |\n| `/build` | Ready to implement | Full context + all tasks in markdown |\n\n---\n\n## Workflow\n\n### Typical Feature Development Cycle\n\n1. **Capture the idea** (in BrainGrid web app or CLI)\n   ```bash\n   braingrid specify --prompt \"Add dark mode toggle with theme persistence\"\n   # \u2192 Creates REQ-42\n   ```\n\n2. **Refine the requirement** (in web app for detailed work, or skip if clear)\n   - Go to https://app.braingrid.ai/requirements\n   - Click \"Specify\" on the requirement\n   - Work with requirements agent to add details, acceptance criteria, technical specs\n   - Agent breaks it into tasks\n\n3. **Create feature branch** (via GitHub API)\n   ```bash\n   braingrid requirement create-branch REQ-42\n   # \u2192 Creates nico/REQ-42-dark-mode\n   git fetch && git checkout nico/REQ-42-dark-mode\n   ```\n\n4. **Get full build context** (for AI agent)\n   ```bash\n   braingrid requirement build REQ-42 --format markdown\n   # Copy output and feed to Claude Code/Cursor\n   ```\n\n5. **Start building** (in Claude Code or Cursor)\n   ```bash\n   /build REQ-42\n   # Agent reads tasks and implements them\n   ```\n\n6. **Track progress** (as tasks complete)\n   ```bash\n   braingrid task update --status IN_PROGRESS\n   # ... implement ...\n   braingrid task update --status COMPLETED\n   ```\n\n7. **Get acceptance review** (before merging)\n   ```bash\n   braingrid requirement review\n   # AI reviews PR against requirement acceptance criteria\n   ```\n\n### Quick Status Check\n\n```bash\nbraingrid status                    # Check auth and project\nbraingrid requirement show          # View current requirement (from branch)\nbraingrid task list -r REQ-42       # List remaining tasks\n```\n\n---\n\n## Common Gotchas\n\n- **Branch name auto-detection fails** \u2014 Make sure your branch name includes the requirement ID in format `feature/REQ-123-description` or `REQ-123-anything`. Branches like `add-dark-mode` won't auto-detect.\n\n- **Task auto-detection picks wrong task** \u2014 `braingrid task show` without a task ID shows the first in-progress task, or first planned task if none in progress. If you have multiple in-progress tasks, specify the task ID explicitly.\n\n- **GitHub App not installed** \u2014 You must have admin/owner permissions on the repo and install the BrainGrid GitHub App before BrainGrid can analyze your codebase. See `/github-installation` for permission requirements.\n\n- **`.braingrid/project.json` missing** \u2014 Run `braingrid init` in your repo root to create it. Without this file, CLI commands won't know which project to use.\n\n- **Requirement shows \"IDEA\" status** \u2014 Requirements start in IDEA status. They must be refined (via web app or `specify` command) to move to PLANNED before tasks can be created.\n\n- **MCP server slower than expected** \u2014 MCP adds latency compared to CLI. If speed matters, use CLI instead. MCP is best for environments where you can't run CLI.\n\n- **Output format not recognized** \u2014 Use only `table`, `json`, `xml`, or `markdown` with `--format`. Other values will error.\n\n- **Task status won't update** \u2014 Task statuses are: `PLANNED`, `IN_PROGRESS`, `COMPLETED`, `CANCELLED`. Typos or invalid statuses will fail silently or error.\n\n- **Requirement review finds no PR** \u2014 `braingrid requirement review` auto-detects PR from current branch. If no PR exists, you'll be prompted to select one. Make sure you've pushed your branch and created a PR first.\n\n- **Circular context indicator in Claude Code** \u2014 This is normal. Hover over it to see token breakdown by category (codebase, requirement, tasks, etc.).\n\n---\n\n## Verification Checklist\n\nBefore submitting work or marking tasks complete:\n\n- [ ] `.braingrid/project.json` exists in repo root\n- [ ] Current branch name includes requirement ID (e.g., `feature/REQ-123-description`)\n- [ ] Requirement has been refined (status is PLANNED or IN_PROGRESS, not IDEA)\n- [ ] All tasks have clear acceptance criteria visible in `braingrid task show`\n- [ ] Task status is accurate (`braingrid task show` reflects actual progress)\n- [ ] Code changes match the task description and acceptance criteria\n- [ ] PR has been created and pushed to GitHub\n- [ ] `braingrid requirement review` passes (or you've reviewed manually against acceptance criteria)\n- [ ] All tasks for the requirement are marked COMPLETED before closing the requirement\n\n---\n\n## Resources\n\n**Comprehensive page-by-page navigation:**\nhttps://docs.braingrid.ai/llms.txt\n\n**Critical documentation pages:**\n1. [Quickstart](https://docs.braingrid.ai/quickstart) \u2014 Step-by-step walkthrough of the full workflow\n2. [CLI Command Reference](https://docs.braingrid.ai/cli/commands) \u2014 Complete command reference with all options\n3. [What is BrainGrid](https://docs.braingrid.ai/what-is-braingrid) \u2014 Conceptual overview of how BrainGrid works\n\n**Integration guides:**\n- [Claude Code setup](https://docs.braingrid.ai/claude-code) \u2014 Slash commands and integration\n- [Cursor setup](https://docs.braingrid.ai/cursor) \u2014 Rules, commands, and MCP installation\n- [MCP Server usage](https://docs.braingrid.ai/mcp-server/usage) \u2014 Tool-based integration for web IDEs\n\n---\n\n> For additional documentation and navigation, see: https://docs.braingrid.ai/llms.txt",
                "uri": "mintlify://skills/braingrid"
              }
            ]
          }
        },
        "resource_uri": "mintlify://skills/braingrid",
        "url": "https://docs.braingrid.ai/mcp"
      },
      "latency_ms": 204.29,
      "status": "ok"
    },
    "resources_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=63072000"
        },
        "http_status": 200,
        "payload": {
          "id": 5,
          "jsonrpc": "2.0",
          "result": {
            "resources": [
              {
                "description": "Use when planning AI-driven development work, creating structured requirements, breaking down features into tasks, and coordinating AI coding agents (Claude Code, Cursor, etc.) to implement features reliably. Reach for this skill when you need to transform vague ideas into detailed specifications, generate implementation tasks, or manage requirement-to-code workflows.",
                "mimeType": "text/markdown",
                "name": "braingrid",
                "uri": "mintlify://skills/braingrid"
              }
            ]
          }
        },
        "url": "https://docs.braingrid.ai/mcp"
      },
      "latency_ms": 130.17,
      "status": "ok"
    },
    "server_card": {
      "details": {
        "headers": {
          "content-type": "application/json",
          "strict-transport-security": "max-age=63072000"
        },
        "http_status": 200,
        "payload": {
          "authentication": "none",
          "capabilities": {
            "resources": true,
            "tools": true
          },
          "description": "Search and retrieve BrainGrid documentation",
          "name": "BrainGrid Docs MCP",
          "serverInfo": {
            "name": "BrainGrid Docs MCP",
            "version": "1.0.0"
          },
          "tools": [
            {
              "annotations": {
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false,
                "readOnlyHint": true
              },
              "description": "Search across the BrainGrid knowledge base to find relevant information, code examples, API references, and guides. Use this tool when you need to answer questions about BrainGrid, find specific documentation, understand how features work, or locate implementation details. The search returns contextual content with titles and direct links to the documentation pages. If you need the full content of a specific page, use the query_docs_filesystem tool to `head` or `cat` the page path (append `.mdx` to the path returned from search \u2014 e.g. `head -200 /api-reference/create-customer.mdx`).",
              "inputSchema": {
                "properties": {
                  "query": {
                    "description": "A query to search the content with.",
                    "type": "string"
                  }
                },
                "required": [
                  "query"
                ],
                "type": "object"
              },
              "name": "search_brain_grid"
            },
            {
              "annotations": {
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": false,
                "readOnlyHint": true
              },
              "description": "Run a read-only shell-like query against a virtualized, in-memory filesystem rooted at `/` that contains ONLY the BrainGrid documentation pages and OpenAPI specs. This is NOT a shell on any real machine \u2014 nothing runs on the user's computer, the server host, or any network. The filesystem is a sandbox backed by documentation chunks.\n\nThis is how you read documentation pages: there is no separate \"get page\" tool. To read a page, pass its `.mdx` path (e.g. `/quickstart.mdx`, `/api-reference/create-customer.mdx`) to `head` or `cat`. To search the docs with exact keyword or regex matches, use `rg`. To understand the docs structure, use `tree` or `ls`.\n\n**Workflow:** Start with the search tool for broad or conceptual queries like \"how to authenticate\" or \"rate limiting\". Use this tool when you need exact keyword/regex matching, structural exploration, or to read the full content of a specific page by path.\n\nSupported commands: rg (ripgrep), grep, find, tree, ls, cat, head, tail, stat, wc, sort, uniq, cut, sed, awk, jq, plus basic text utilities. No writes, no network, no process control. Run `--help` on any command for usage.\n\nEach call is STATELESS: the working directory always resets to `/` and no shell variables, aliases, or history carry over between calls. If you need to operate in a subdirectory, chain commands in one call with `&&` or pass absolute paths (e.g., `cd /api-reference && ls` or `ls /api-reference`). Do NOT assume that `cd` in one call affects the next call.\n\nExamples:\n- `tree / -L 2` \u2014 see the top-level directory layout\n- `rg -il \"rate limit\" /` \u2014 find all files mentioning \"rate limit\"\n- `rg -C 3 \"apiKey\" /api-reference/` \u2014 show matches with 3 lines of context around each hit\n- `head -80 /quickstart.mdx` \u2014 read the top 80 lines of a specific page\n- `head -80 /quickstart.mdx /installation.mdx /guides/first-deploy.mdx` \u2014 read multiple pages in one call\n- `cat /api-reference/create-customer.mdx` \u2014 read a full page when you need everything\n- `cat /openapi/spec.json | jq '.paths | keys'` \u2014 list OpenAPI endpoints\n\nOutput is truncated to 30KB per call. Prefer targeted `rg -C` or `head -N` over broad `cat` on large files. To read only the relevant sections of a large file, use `rg -C 3 \"pattern\" /path/file.mdx`. Batch multiple file reads into a single `head` or `cat` call whenever possible.\n\nWhen referencing pages in your response to the user, convert filesystem paths to URL paths by removing the `.mdx` extension. For example, `/quickstart.mdx` becomes `/quickstart` and `/api-reference/overview.mdx` becomes `/api-reference/overview`.",
              "inputSchema": {
                "properties": {
                  "command": {
                    "description": "A shell command to run against the virtualized documentation filesystem (e.g., `rg -il \"keyword\" /`, `tree / -L 2`, `head -80 /path/file.mdx`).",
                    "type": "string"
                  }
                },
                "required": [
                  "command"
                ],
                "type": "object"
              },
              "name": "query_docs_filesystem_brain_grid"
            }
          ],
          "transport": "http",
          "url": "https://braingrid.main-kill-isr.mintlify.me/mcp",
          "version": "1.0.0"
        },
        "url": "https://docs.braingrid.ai/.well-known/mcp/server-card.json"
      },
      "latency_ms": 532.32,
      "status": "ok"
    },
    "session_resume_probe": {
      "details": {
        "protocol_version": "2025-03-26",
        "reason": "no_session_id",
        "resume_expected": true,
        "transport": "streamable-http"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "step_up_auth_probe": {
      "details": {
        "auth_required_checks": [],
        "broad_scopes": [],
        "challenge_headers": [],
        "minimal_scope_documented": false,
        "oauth_present": false,
        "scope_specificity_ratio": 0.0,
        "step_up_signals": [],
        "supported_scopes": []
      },
      "latency_ms": null,
      "status": "missing"
    },
    "tool_snapshot_probe": {
      "details": {
        "current_tool_count": 3,
        "reason": "no_historical_snapshot"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "tools_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=63072000"
        },
        "http_status": 200,
        "payload": {
          "id": 2,
          "jsonrpc": "2.0",
          "result": {
            "tools": [
              {
                "annotations": {
                  "destructiveHint": false,
                  "idempotentHint": true,
                  "openWorldHint": false,
                  "readOnlyHint": true
                },
                "description": "Search across the BrainGrid knowledge base to find relevant information, code examples, API references, and guides. Use this tool when you need to answer questions about BrainGrid, find specific documentation, understand how features work, or locate implementation details. The search returns contextual content with titles and direct links to the documentation pages. If you need the full content of a specific page, use the query_docs_filesystem tool to `head` or `cat` the page path (append `.mdx` to the path returned from search \u2014 e.g. `head -200 /api-reference/create-customer.mdx`).",
                "execution": {
                  "taskSupport": "forbidden"
                },
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "query": {
                      "description": "Search query",
                      "type": "string"
                    }
                  },
                  "required": [
                    "query"
                  ],
                  "type": "object"
                },
                "name": "search_brain_grid",
                "title": "Search documentation"
              },
              {
                "annotations": {
                  "destructiveHint": false,
                  "idempotentHint": true,
                  "openWorldHint": false,
                  "readOnlyHint": true
                },
                "description": "Run a read-only shell-like query against a virtualized, in-memory filesystem rooted at `/` that contains ONLY the BrainGrid documentation pages and OpenAPI specs. This is NOT a shell on any real machine \u2014 nothing runs on the user's computer, the server host, or any network. The filesystem is a sandbox backed by documentation chunks.\n\nThis is how you read documentation pages: there is no separate \"get page\" tool. To read a page, pass its `.mdx` path (e.g. `/quickstart.mdx`, `/api-reference/create-customer.mdx`) to `head` or `cat`. To search the docs with exact keyword or regex matches, use `rg`. To understand the docs structure, use `tree` or `ls`.\n\n**Workflow:** Start with the search tool for broad or conceptual queries like \"how to authenticate\" or \"rate limiting\". Use this tool when you need exact keyword/regex matching, structural exploration, or to read the full content of a specific page by path.\n\nSupported commands: rg (ripgrep), grep, find, tree, ls, cat, head, tail, stat, wc, sort, uniq, cut, sed, awk, jq, plus basic text utilities. No writes, no network, no process control. Run `--help` on any command for usage.\n\nEach call is STATELESS: the working directory always resets to `/` and no shell variables, aliases, or history carry over between calls. If you need to operate in a subdirectory, chain commands in one call with `&&` or pass absolute paths (e.g., `cd /api-reference && ls` or `ls /api-reference`). Do NOT assume that `cd` in one call affects the next call.\n\nExamples:\n- `tree / -L 2` \u2014 see the top-level directory layout\n- `rg -il \"rate limit\" /` \u2014 find all files mentioning \"rate limit\"\n- `rg -C 3 \"apiKey\" /api-reference/` \u2014 show matches with 3 lines of context around each hit\n- `head -80 /quickstart.mdx` \u2014 read the top 80 lines of a specific page\n- `head -80 /quickstart.mdx /installation.mdx /guides/first-deploy.mdx` \u2014 read multiple pages in one call\n- `cat /api-reference/create-customer.mdx` \u2014 read a full page when you need everything\n- `cat /openapi/spec.json | jq '.paths | keys'` \u2014 list OpenAPI endpoints\n\nOutput is truncated to 30KB per call. Prefer targeted `rg -C` or `head -N` over broad `cat` on large files. To read only the relevant sections of a large file, use `rg -C 3 \"pattern\" /path/file.mdx`. Batch multiple file reads into a single `head` or `cat` call whenever possible.\n\nWhen referencing pages in your response to the user, convert filesystem paths to URL paths by removing the `.mdx` extension. For example, `/quickstart.mdx` becomes `/quickstart` and `/api-reference/overview.mdx` becomes `/api-reference/overview`.",
                "execution": {
                  "taskSupport": "forbidden"
                },
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "command": {
                      "description": "A shell command to run against the virtualized documentation filesystem (e.g., `rg -il \"keyword\" /`, `tree / -L 2`, `head -80 /path/file.mdx`).",
                      "type": "string"
                    }
                  },
                  "required": [
                    "command"
                  ],
                  "type": "object"
                },
                "name": "query_docs_filesystem_brain_grid"
              },
              {
                "annotations": {
                  "destructiveHint": false,
                  "idempotentHint": false,
                  "openWorldHint": true,
                  "readOnlyHint": false
                },
                "description": "Report a problem with this documentation site so the docs team can fix it. Use when a documentation page is incorrect, outdated, confusing, incomplete, or has a broken example. This is for feedback about the documentation content itself \u2014 not for product support requests or feedback about this tool or assistant.",
                "execution": {
                  "taskSupport": "forbidden"
                },
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "feedback": {
                      "description": "A clear description of the documentation issue or suggestion \u2014 what is incorrect, outdated, missing, or confusing.",
                      "minLength": 1,
                      "type": "string"
                    },
                    "path": {
                      "description": "The documentation page path the feedback is about (e.g., the page you were reading, such as `/quickstart`).",
                      "minLength": 1,
                      "type": "string"
                    }
                  },
                  "required": [
                    "path",
                    "feedback"
                  ],
                  "type": "object"
                },
                "name": "submit_feedback",
                "title": "Submit documentation feedback"
              }
            ]
          }
        },
        "url": "https://docs.braingrid.ai/mcp"
      },
      "latency_ms": 173.6,
      "status": "ok"
    },
    "transport_compliance_probe": {
      "details": {
        "bad_protocol_error": null,
        "bad_protocol_headers": {
          "content-type": "application/json",
          "strict-transport-security": "max-age=63072000"
        },
        "bad_protocol_payload": {
          "error": {
            "code": -32000,
            "message": "Bad Request: Unsupported protocol version: 1999-99-99 (supported versions: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07)"
          },
          "id": null,
          "jsonrpc": "2.0"
        },
        "bad_protocol_status_code": 400,
        "delete_error": null,
        "delete_status_code": null,
        "expired_session_error": null,
        "expired_session_status_code": null,
        "issues": [
          "missing_session_id",
          "missing_protocol_header"
        ],
        "last_event_id_visible": false,
        "protocol_header_present": false,
        "requested_protocol_version": "2025-03-26",
        "session_id_present": false,
        "transport": "streamable-http"
      },
      "latency_ms": 151.07,
      "status": "warning"
    },
    "utility_coverage_probe": {
      "details": {
        "completions": {
          "advertised": false,
          "live_probe": "not_executed",
          "sample_target": {
            "type": "resource",
            "uri": "mintlify://skills/braingrid"
          }
        },
        "initialize_capability_keys": [
          "resources",
          "tools"
        ],
        "pagination": {
          "metadata_signal": false,
          "next_cursor_methods": [],
          "supported": false
        },
        "tasks": {
          "advertised": false,
          "http_status": 200,
          "probe_status": "missing"
        }
      },
      "latency_ms": 88.93,
      "status": "missing"
    }
  },
  "failures": {
    "oauth_authorization_server": {
      "reason": "no_authorization_server"
    },
    "oauth_protected_resource": {
      "error": "Client error '404 Not Found' for url 'https://docs.braingrid.ai/.well-known/oauth-protected-resource'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
      "url": "https://docs.braingrid.ai/.well-known/oauth-protected-resource"
    },
    "openid_configuration": {
      "reason": "no_authorization_server"
    }
  },
  "remote_url": "https://docs.braingrid.ai/mcp",
  "server_card_payload": null,
  "server_identifier": "awesome/braingrid-mcp"
}