Mastra Docs MCP (official)

90/100
Last tested 2026-11-11 (Fresh: tested within 30 days) Working (tool call tested 2026-11-11) No key needed for the tools we called

No advisories in range for tested 1.3.12 (checked 2026-11-11)

Security review: not tested

Score = points from our five tests (install, handshake, maintenance, docs, license). Not a quality or security rating. Methodology

  • Install20/20
  • Handshake30/30
  • Maintenance25/25
  • Docs5/15
  • License10/10

Tested npm @mastra/mcp-docs-server 1.3.12 (Apache-2.0 per npm; Mastra monorepo mastra-ai/mastra). Stdio server, 13 tools, no key. Real calls: mastraDocs (docs index) and mastraMigration (migration guides) returned content. searchMastraDocs and getMastraHelp read docs embedded in an installed Mastra project; our test folder had none, so searchMastraDocs returned 'No Mastra packages found.' (counted as not passed) and getMastraHelp (help self-check) does not count. Mastra's docs now recommend its agent skill over this server for everyday use.
Tool-call test (2026-11-11, direct MCP stdio client, no LLM): partial. 2 of 3 function calls passed; project-embedded docs search needs an installed Mastra project (not set up). Evidence: local test run, Nov 11, 2026.

Transport (tested 2026-11-11): stdio

Token cost (estimate): approx. 3193 tokens, cl100k estimate (13 tools, measured 2026-11-11, version 1.3.12). This is an estimate from our testing of the tool names, descriptions and input schemas, counted with cl100k_base.

Permissions: 6 read, 4 write (state-changing), 3 unclassified · Auth: none · Rate limit: unknown · Pricing unit: unknown

Auth: none. Rate limit: unknown. Pricing unit: unknown.

  • clearMastraCourseHistory — write (state-changing)
  • getMastraCourseStatus — read
  • getMastraExportDetails — write (state-changing)
  • getMastraExports — read
  • getMastraHelp — read
  • listMastraPackages — read
  • mastraDocs — unclassified
  • mastraMigration — unclassified
  • nextMastraCourseStep — unclassified
  • readMastraDocs — read
  • searchMastraDocs — read
  • startMastraCourse — write (state-changing)
  • startMastraCourseLesson — write (state-changing)

handshake and tools listed without a recorded key or OAuth

Score 90/100 · Tools 13 · Token cost approx. 3,193 tokens · Compare · Last tested 2026-11-11 · Version tested 1.3.12 · Package @mastra/mcp-docs-server · Repo mastra-ai/mastra

Summary: Mastra Docs MCP (official) completed an MCP handshake without credentials and exposed 13 tools.

Evidence summary

Handshake
pass
Tools listed
13
Context cost
approx. 3193 tokens, cl100k estimate (13 tools, measured 2026-11-11, version 1.3.12; an estimate) ranking · add up your servers' context cost
API key
No key needed for the tools we called
Tested
2026-11-11

Test results

TestResultPointsEvidence
installpass20npm install @mastra/mcp-docs-server (Node 20, Linux) succeeded in 5s.
handshakepass30MCP initialize + tools/list over stdio succeeded with no credentials; 13 tools listed in 5.2s.
maintenancepass25Repo pushed 0 days before test; 29,462 GitHub stars.
docspartial5install instructions present. Check of the package's own README (README shipped in npm package).
licensepass10Apache-2.0 (OSI-approved).

Local-model readiness

Token cost (estimate): approx. 3193 tokens, cl100k estimate for 13 tools · about 39% of an 8k context. This is an estimate from our testing (counted with cl100k_base).

Small-model friendly (schema heuristic, not a model result): unknown.

Not tested

Small-model task runs: Not yet tested.

What we tested and what we didn't

Tested on 2026-11-11

  • Install from the registry
  • We connected with no credentials and asked for its tool list: it listed 13 tools (Method details: MCP initialize then tools/list)
  • Maintenance signals (last push, archived/deprecated status)
  • Docs (README length, install and config example)
  • License (OSI-approved or not)
  • Token cost (estimate)

Not tested

  • Security: not audited (no code review, no permission or data-flow analysis)
  • Real tasks (no functional task runs yet)
  • Behaviour with real credentials or a real account
  • Performance, rate limits or load
  • Correctness of results beyond the listed tasks

Methodology: how we test. A high score means it installs and responds, not that giving it access to your data carries no risk.

Known security issues

Checked on 2026-11-11 for version 1.3.12 against OSV, GitHub advisories, GitHub repository advisories. Scope: the package itself; dependencies not scanned.

No published advisories found in OSV and GitHub advisories whose affected range includes @mastra/mcp-docs-server 1.3.12 as of 2026-11-11. This is not a security audit.

Other advisories we checked (1)

Monthly roundup: MCP security issues, October 2026.

Tool list changes

Baseline recorded from the 2026-11-11 test run; changes appear after the next test.

Snapshot hash (fingerprint of the tool list)

fa34f52ad8e5: SHA-256 of the canonical tool names, descriptions and input schemas. If it changes, the tool list changed.

Feeds: RSS · JSON.

Raw test record (JSON)
{
  "name": "@mastra/mcp-docs-server",
  "version": "1.3.12",
  "registry": "npm",
  "status": "working",
  "tested": "2026-11-11",
  "tools_count": 13,
  "deprecated": false,
  "archived": false,
  "tests": {
    "install": [
      "pass",
      20,
      "`npm install @mastra/mcp-docs-server` (Node 20, Linux) succeeded in 5s."
    ],
    "handshake": [
      "pass",
      30,
      "MCP `initialize` + `tools/list` over stdio succeeded with no credentials; 13 tools listed in 5.2s."
    ],
    "maintenance": [
      "pass",
      25,
      "Repo pushed 0 days before test; 29,462 GitHub stars."
    ],
    "docs": [
      "partial",
      5,
      "install instructions present. Check of the package's own README (README shipped in npm package)."
    ],
    "license": [
      "pass",
      10,
      "Apache-2.0 (OSI-approved)."
    ]
  }
}

Install

npx -y @mastra/mcp-docs-server

Pin the version we tested

npx -y @mastra/mcp-docs-server@1.3.12

tested 2026-11-11. Newer versions may differ and were not tested by us.

{
  "mcpServers": {
    "mastra-docs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mastra/mcp-docs-server@1.3.12"
      ]
    }
  }
}

Tools listed

clearMastraCourseHistory, getMastraCourseStatus, getMastraExportDetails, getMastraExports, getMastraHelp, listMastraPackages, mastraDocs, mastraMigration, nextMastraCourseStep, readMastraDocs, searchMastraDocs, startMastraCourse, startMastraCourseLesson

Tool history: captured Nov 11, 2026. All tool history.

Quick config

{
  "mcpServers": {
    "mastra-docs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mastra/mcp-docs-server"
      ]
    }
  }
}

Add to config Opens the config generator with this server selected.

Setup

  1. Install. Run npm install @mastra/mcp-docs-server (Node 20). This is the exact command we ran on 2026-11-11.
  2. Configure. Add the mcpServers entry below to your MCP client config.
  3. Verify. Restart the client and check that tools/list returns tools (13 in our test).
{
  "mcpServers": {
    "mastra-docs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mastra/mcp-docs-server"
      ]
    }
  }
}

Test history

Follow this server (RSS) · Monthly changelog

Related: Best docs MCP servers

FAQ

Is Mastra Docs MCP deprecated?

No. @mastra/mcp-docs-server was not deprecated or archived when we last tested it on 2026-11-11.

What replaces Mastra Docs MCP?

Nothing; Mastra Docs MCP (official) is not deprecated as of 2026-11-11.

Does Mastra Docs MCP need an API key?

No. It completed an MCP handshake with no credentials and listed 13 tools.

Embed the badge

TestedMCP: 90/100, tested 2026-11-11

Every tested server gets a free embeddable badge. It shows the current score and test date and expires after 90 days. Testing is free; payment never changes a score.

Claim this listing · Report an issue