Skip to content

coldbox ai install registers wrong MCP server URL for BoxLang core docs #80

Description

@edyionescu

What are the steps to reproduce this issue?

  1. Run coldbox ai install in a ColdBox project.
  2. Open the generated AGENTS.md and/or .mcp.json.
  3. Find the boxlang MCP server entry and note its url.
  4. Query that MCP server for core BoxLang documentation.

What happens?

The boxlang MCP server entry is registered with url: https://ai.ortusbooks.com/~gitbook/mcp, which is the documentation site for the BoxLang AI module, not the core BoxLang documentation.

This appears in https://github.com/ColdBox/coldbox-cli/blob/development/models/MCPRegistry.cfc#L43

"boxlang" : {
    "name"        : "boxlang",
    "description" : "BoxLang Language Documentation",
    "url"         : "https://ai.ortusbooks.com/~gitbook/mcp"
},

What were you expecting to happen?

The entry should point at the core BoxLang language documentation site instead:

"boxlang" : {
    "name"        : "boxlang",
    "description" : "BoxLang Language Documentation",
    "url"         : "https://boxlang.ortusbooks.com/~gitbook/mcp"
},

Any logs, error output, etc?

Encountered this firsthand in a Claude session when it queried the boxlang MCP server twice expecting core language documentation and got irrelevant AI-module results both times:

That MCP search hit the wrong docs server (AI module, not core BoxLang).

This MCP server (mcp__boxlang__searchDocumentation) is wired to the BoxLang AI module docs, not core BoxLang language docs — not useful here despite the AGENTS.md claiming it covers core language.

What versions are you using?

Operating System: Windows 11 Pro 25H2
Package Version: 8.13.0+31

Metadata

Metadata

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions