MCP Server

The MCP (Model Context Protocol) server connects noodlbox to agents like Claude Code, Cursor, Codex, and OpenCode, enabling intelligent code exploration and analysis.

What is MCP?

MCP is a protocol that allows agents to access external tools and data. The noodlbox MCP server exposes your code knowledge graph through:

• Tools - Execute operations like queries and searches
• Resources - Access structured data like maps and schemas

Quick Setup

The installer runs noodl init automatically, which configures MCP for all your agents. The MCP server uses STDIO transport - your agent launches it automatically when needed.

Agent-first workflow: After setup, your agent can analyze repositories directly via MCP tools - no CLI commands needed.

For manual configuration:

claude plugin marketplace add noodlbox/noodlbox-claude-plugins
claude plugin install noodlbox@noodlbox

{
  "mcpServers": {
    "noodlbox": {
      "command": "noodl",
      "args": ["mcp"]
    }
  }
}

[mcp_servers.noodlbox]
command = "noodl"
args = ["mcp"]

{
  "mcp": {
    "noodlbox": {
      "type": "local",
      "command": ["noodl", "mcp"]
    }
  }
}

Full setup guide →

Tools

The MCP server provides tools for interacting with noodlbox.

Query Tools

Refactoring Tools

Management Tools

Resources

Access structured data through MCP resources using @noodlbox:uri syntax:

Tools vs Resources

Example Session

You: "Show me my repositories"
→ Uses @noodlbox:repository://list

You: "What communities are in owner/my-app?"
→ Uses @noodlbox:map://owner/my-app

You: "Find code related to authentication"
→ Uses noodlbox_query_with_context tool

You: "Show me everything about the authenticateUser function"
→ Uses noodlbox_symbol_context tool

You: "Rename getUserById to findUserById"
→ Uses noodlbox_rename_symbol tool

You: "What would be affected if I change the login function?"
→ Uses noodlbox_detect_impact tool

Security

MCP operations are:

• Authenticated - Requires valid authentication via noodl auth
• Local - Data stays on your machine
• Code-safe - Cannot modify your source code

Management tools (analyze, delete) modify the knowledge graph but never touch your source files.

Learn More

• Setup Guide - Installation and configuration
• Context Search - Natural language code search
• Cypher Query - Graph query examples