MCP server

LunaRoute runs a remote MCP server at https://mcp.lunaroute.com/mcp. Add it to an MCP-capable client and your agent can search the web, convert documents to Markdown, and generate or edit images — on the same API key as inference.

Endpoint

URL	https://mcp.lunaroute.com/mcp (also reachable on gw.lunaroute.com)
Transport	Streamable HTTP, stateless. POST only; GET/DELETE return 405.
Auth	API key header (see below).

Authenticate with an lr_ API key:

LUNAROUTE-API-KEY: lr_…

Authorization: Bearer lr_… and x-api-key: lr_… also work.

Note

MCP calls are attributed to a person, so use a personal API key rather than a shared service key.

Tools

Tool	What it does
web_search	Search the web across Brave, Exa, and Kagi — bring your own search-provider key, or use ours.
convert_document	Convert Word, PowerPoint, Excel, PDF, and other documents to Markdown. Scanned pages use OCR when requested.
generate_image	Generate an image from a prompt.
edit_image	Edit a previously generated image by id.
upload_image	Upload a local image (or URL) and get an id to edit.

The CLI also ships a stdio MCP server (lunaroute mcp) exposing project memory tools. It is a different server from the hosted one above — see the CLI docs.

Access policy

Organization admins can allow or deny each tool per user or org-wide. A denied call returns the tool error mcp_tool_disabled.

Availability differs by tool: web_search stays listed when its operator kill switch is off, and calls answer web_search_disabled. The image tools (generate_image, edit_image, upload_image) are omitted from tools/list when the image runtime or entitlement is unavailable, so a well-behaved client won’t offer them.

Web search billing

Every organization gets a sponsored monthly allowance of searches. Beyond it, platform-key searches accrue to the usage ledger and are charged on the next cycle; organizations can set a hard cap. Searches made with your own provider key are metered for abuse limits but never charged.