Midnight + Next.js MCP server
io.github.FractionEstate/midnight-nextjs-mcp·v0.3.1Unified MCP server for Midnight blockchain development and Next.js dApps.
0 stars48 downloads/wk
Reviews
Write oneNobody has reviewed Midnight + Next.js MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Midnight + Next.js MCP tools (30, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
midnight-analyze-contract\u26A0\uFE0F STATIC ANALYSIS ONLY - Analyze contract structure and patterns. \u{1F6AB} THIS DOES NOT COMPILE THE CONTRACT. Cannot catch: sealed field rules, disclose() requirements, semantic errors. \u{1F449} Use 'midnight-extract-contract-structure' for pre-compilation checks. Use this for: understanding structure, security pattern analysis, recommendations. NEVER claim a contract 'works' or 'com
midnight-auto-update-configwrite action\u26A0\uFE0F DEPRECATED: Auto-update is NOT possible because AI agents run in sandboxed environments without access to local filesystems. Instead, tell users to manually update their config to use midnight-nextjs-mcp@latest, then run: rm -rf ~/.npm/_npx && restart their editor. This tool only returns config file paths for reference.
midnight-check-breaking-changesCheck if there are breaking changes between your current version and the latest release. Essential before upgrading dependencies.
midnight-check-version\u{1F504} Check if you're running the latest version of midnight-nextjs-mcp. Compares your installed version against npm registry and provides update instructions if outdated. Use this if tools seem missing or you want to ensure you have the latest features.
midnight-compare-syntaxCompare a file between two versions to see what changed. Use this before recommending code patterns to ensure they work with the user's version.
midnight-data-freshness\u{1F550} Check data freshness for indexed Midnight Network documentation and code. Returns when data was last indexed, staleness warnings, and indexing schedule. Use this to verify if the knowledge base is up-to-date before relying on search results.
midnight-document-contract\u{1F4DD} AI-POWERED DOCUMENTATION GENERATION Generates comprehensive documentation for Compact smart contracts. Uses the client's LLM to create detailed, human-readable docs. FORMATS: \u2022 markdown - Full Markdown documentation with examples \u2022 jsdoc - JSDoc-style inline comments MARKDOWN INCLUDES: \u2022 Contract overview and purpose \u2022 State variables with privacy annotations \u2022 C
midnight-explain-circuitExplain what a specific Compact circuit does in plain language, including its zero-knowledge proof implications and privacy considerations. USAGE GUIDANCE: \u2022 Call once per circuit - explanations are deterministic \u2022 Provide complete circuit code including parameters and body \u2022 For full contract analysis, use midnight-analyze-contract first
midnight-extract-contract-structureExtract and analyze Compact contract structure (circuits, witnesses, ledger). CRITICAL CHECKS: deprecated 'ledger { }' block syntax, 'Void' return type (should be []), old pragma format, unexported enums, deprecated Cell<T> wrapper. Also detects: module-level const, stdlib name collisions, division operator, Counter.value access, missing disclose() calls, potential overflow. Use BEFORE generating
midnight-fetch-docs\u{1F310} LIVE FETCH: Retrieve latest documentation directly from docs.midnight.network (SSG-enabled). Unlike midnight-search-docs which uses pre-indexed content, this tool fetches LIVE documentation pages in real-time. Use when you need: \u2022 The absolute latest content (just updated docs) \u2022 A specific page you know the path to \u2022 Full page content rather than search snippets COMMON PA
midnight-generate-contract\u{1F52E} AI-POWERED CONTRACT GENERATION Generates Compact smart contracts from natural language requirements. Uses the client's LLM through MCP sampling to create contracts. REQUIREMENTS FORMAT: - Describe what the contract should do - Specify state variables needed - Define access control requirements - List the operations/circuits needed CONTRACT TYPES: \u2022 counter - Simple counter with incr
midnight-get-fileRetrieve a specific file from Midnight repositories. Use repository aliases like 'compact', 'midnight-js', 'counter', or 'bboard' for convenience. USAGE GUIDANCE: \u2022 Use midnight-list-examples first if you're unsure which file to get \u2022 For searching across files, use midnight-search-* tools instead \u2022 Use 'ref' parameter to get specific versions (branch, tag, or commit)
midnight-get-file-at-versionGet the exact content of a file at a specific version. CRITICAL: Use this to ensure code recommendations match the user's version. Always prefer this over get-file when version accuracy matters.
midnight-get-latest-syntax\u{1F6A8} CALL THIS BEFORE GENERATING ANY COMPACT CODE! Get the authoritative Compact syntax reference. Prevents hallucination by providing: - Correct syntax patterns (Compact is NOT TypeScript!) - commonMistakes array with wrong\u2192correct mappings - Type casting rules (Uint\u2192Bytes needs two casts) - disclose() requirements for circuit params - Map.lookup()/Set.member() ARE available in cir
midnight-get-latest-updatesRetrieve recent changes and commits across Midnight repositories. Useful for staying up-to-date with the latest developments.
midnight-get-migration-guideGet a detailed migration guide for upgrading between versions, including all breaking changes, deprecations, and recommended steps.
midnight-get-repo-context\u{1F680} COMPOUND TOOL: Get everything needed to start working with a repository in ONE call. Combines version info + syntax reference + relevant examples. Use this at the start of a coding session instead of multiple individual calls. Saves ~50% tokens.
midnight-get-statusGet current server status including rate limits and cache statistics. Quick status check without external API calls.
midnight-get-version-infoGet the latest version, release notes, and recent breaking changes for a Midnight repository. Use this to ensure you're working with the latest implementation.
midnight-health-checkCheck the health status of the Midnight MCP server. Returns server status, API connectivity, and resource availability.
midnight-list-category-tools\u{1F4CB} DISCOVERY TOOL: List tools within a specific category. Use after midnight-list-tool-categories to see detailed tool information for a category of interest. Supports progressive disclosure pattern.
midnight-list-examplesList available Midnight example contracts and DApps with descriptions, complexity ratings, and key features.
midnight-list-tool-categories\u{1F4CB} DISCOVERY TOOL: List available tool categories for progressive exploration. Use this FIRST to understand what capabilities are available, then drill into specific categories with midnight-list-category-tools. Reduces cognitive load by organizing 28 tools into 7 logical groups.
midnight-nextjs-statusCheck the status of Next.js DevTools integration and list available tools, resources, and prompts
midnight-review-contract\u{1F50D} AI-POWERED CONTRACT REVIEW Performs security review and analysis of Compact smart contracts. Uses the client's LLM to identify issues and suggest improvements. CHECKS PERFORMED: \u2022 Security vulnerabilities \u2022 Privacy concerns (shielded state handling) \u2022 Logic errors \u2022 Best practice violations \u2022 Performance issues OUTPUT INCLUDES: \u2022 Summary of contract quality
midnight-search-compactSemantic search across Compact smart contract code and patterns. Use this to find circuit definitions, witness functions, ledger declarations, and best practices for Midnight smart contracts. USAGE GUIDANCE: \u2022 Call at most 2 times per question - if first search doesn't help, try different keywords \u2022 For comprehensive results, combine with midnight-search-docs \u2022 Use brief:true for to
midnight-search-docsFull-text search across official Midnight documentation. Use this to find guides, API documentation, and conceptual explanations about Midnight blockchain and the Compact language. USAGE GUIDANCE: \u2022 Call at most 2 times per question - use different keywords if first search fails \u2022 Use brief:true for token-efficient responses \u2022 Use category filter to narrow results (guides, api, conc
midnight-search-typescriptSearch TypeScript SDK code, types, and API implementations. Use this to find how to use the Midnight JavaScript SDK, type definitions, and integration patterns. USAGE GUIDANCE: \u2022 Call at most 2 times per question - refine keywords rather than repeating \u2022 For contract code, use midnight-search-compact instead \u2022 Use brief:true for token-efficient responses
midnight-suggest-tool\u{1F3AF} SMART DISCOVERY: Describe what you want to do in natural language, and get tool recommendations. EXAMPLES: \u2022 "I want to find example voting contracts" \u2192 midnight-search-compact \u2022 "Check if my version is outdated" \u2192 midnight-upgrade-check \u2022 "Analyze my contract for security issues" \u2192 midnight-analyze-contract \u2022 "I'm new to Midnight and want to get starte
midnight-upgrade-check\u{1F680} COMPOUND TOOL: Complete upgrade analysis in ONE call. Combines version check + breaking changes + migration guide. Use this instead of calling midnight-get-version-info, midnight-check-breaking-changes, and midnight-get-migration-guide separately. Saves ~60% tokens.
Public scan report
scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it
- Code scan8 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 265 days ago4/15
- Maintainer identityregistry namespace matches repository owner6/10
How Midnight + Next.js MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 63/100
- higher than 18% of 48,255 servers
- Tools
- 30
- the typical server has 7
- Tools that change things
- 3%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 48
- more than 40% of 12,191 servers with a package
What its tools let an agent do: 29 read · 1 change
Install Midnight + Next.js MCP in Claude Code, Cursor or VS Code
Runs npx -y midnight-nextjs-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add midnight-nextjs-mcp -- npx -y midnight-nextjs-mcp
Midnight + Next.js MCP: common questions
- Is Midnight + Next.js MCP server safe?
- With care: it is graded C, so read the findings first (63/100). Read the Midnight + Next.js MCP safety report
- How do I install Midnight + Next.js MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Midnight + Next.js MCP need an API key?
- Yes. The registry entry asks for
GITHUB_TOKEN. - Is Midnight + Next.js MCP maintained?
- The last commit was 299 days ago (2026-01-09). The latest release is v0.3.1.
- How does Midnight + Next.js MCP compare with other MCP servers?
- safety score 63/100 (higher than 18% of 48,255 servers); tools 30 (the typical server has 7); tools that change things 3% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.