Other Agents

If your AI coding agent isn't directly supported by noodl configure, you can manually configure the MCP server to access Noodlbox tools and resources.

MCP Configuration

Add the following to your agent's MCP configuration file:

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

The configuration key varies by agent:

Most agents use mcpServers (Claude Code, Cursor, VS Code)
Some agents use servers or mcp_servers

Check your agent's documentation for the correct configuration format and file location.

Project Setup

After configuring MCP, set up noodlbox context in each project. Ask your AI agent:

Read the setup:// MCP resource and write it to AGENTS.md in the project root

This creates an AGENTS.md file with noodlbox context that your agent will use for codebase understanding.

Alternatively, you can manually create the file by running:

noodl mcp resource read setup:// > AGENTS.md

Available Tools

Once configured, your agent has access to these MCP tools:

Tool	Purpose
`noodlbox_query_with_context`	Semantic code search returning execution flows
`noodlbox_detect_impact`	Analyze git changes and their ripple effects
`noodlbox_raw_cypher_query`	Direct graph queries for advanced analysis
`noodlbox_analyze`	Index a new repository
`noodlbox_delete`	Remove a repository from the index

Available Resources

Resource	Description
`repository://list`	List of indexed repositories
`setup://`	AGENTS.md content for project initialization
`db://schema/{repository}`	Database schema for a repository
`map://{repository}`	Codebase overview map
`map://{repository}/community/{id}`	Community detail view
`map://{repository}/process/{id}`	Process execution trace

Workflow: First-Time Setup

For a new repository:

# 1. Install noodlbox CLI
brew install noodlbox/tap/noodl

# 2. Analyze the codebase
noodl analyze /path/to/repo

# 3. Configure your agent's MCP (see above)

# 4. Set up project context
# Ask your agent: "Read the setup:// MCP resource and write it to AGENTS.md"

Troubleshooting

MCP Tools Not Available

Verify noodl is in PATH: which noodl
Test MCP server manually: noodl mcp
Check your agent's MCP configuration file location and format

No Search Results

Verify repository is indexed: noodl list
Re-analyze if needed: noodl analyze .

Connection Issues

The MCP server uses stdio transport. Ensure your agent supports stdio-based MCP servers.

Getting Started - Installation and CLI setup
MCP Tools - Detailed tool documentation
MCP Resources - Resource documentation

On this page