# Foxora as an MCP server

Use Foxora's tools inside other apps. Copy one JSON snippet from Settings → MCP Server into Claude Desktop, Cursor, or any MCP client, and those apps gain a safe, read-only-plus-web slice of Foxora's toolbelt.

## Copy the config

- 01Open the MCP Server sectionOpen Settings (⌘, / Ctrl+,) → MCP Server. The Configuration card shows a JSON snippet pointing at your local Foxora engine’s /mcp endpoint.Settings · MCP ServerSettings → MCP Server → Configuration.
- 02Paste it into your MCP clientCopy the snippet and paste it into the app’s MCP config — for example, Claude Desktop → Settings → Developer, or Cursor’s MCP settings. The exact endpoint matches your running engine:Claude Desktop / Cursor — mcpServersCopy{
  "mcpServers": {
    "foxora": {
      "url": "http://127.0.0.1:4097/mcp"
    }
  }
}
- 03Use Foxora's toolsRestart or reload the MCP client. Foxora now appears as a tool server named foxora, and the app can call the exposed tools below.

## The six web-safe tools

Foxora deliberately exposes only a small, read-only-plus-web slice of its toolbelt over MCP:

- read_file — read a file’s contents.
- list_dir — list a directory.
- find_file — locate files by name.
- grep — search file contents.
- web_search — search the web.
- web_fetch — fetch a URL.

> Shell and write are not exposedThe MCP server is read-only and web-only by design. Shell execution and file-writing tools are deliberately not exposed — an outside app talking to Foxora over MCP can inspect and search, but cannot run commands or modify your files. To let an agent act, build it inside Foxora instead.

> Local endpointThe URL in the snippet points at your machine’s Foxora engine (the local /mcp endpoint). It works while Foxora is running on that device — copy the exact value the Settings card shows rather than hardcoding a port.