nixfredFLOXFIELD GUIDE · BY NIX UNOFFICIAL
ObjectionsSecurityFAQGlossaryBlog digestWhat is FloxNix 101ArchitectureAgentsEnterpriseUnofficial. Not affiliated with Flox.
TOOLS / MCP SERVER

Use this guide in your own agent

This site runs a read-only MCP server over streamable HTTP. It fetches Flox's docs live from llms.txt and each page's .md version, keeps them in memory for about 10 minutes, and serves this guide's own pages too. No tool writes anything, and no LLM or API key is involved.

This server only reads documentation. It does not run Flox commands or touch your machine. For agents that need to operate Flox itself, see the Flox agent skills described on the agents page.

Endpoint

https://flox.nixfred.com/mcp

Tools

list_pages

Every Flox doc page from https://flox.dev/docs/llms.txt: section, title, URL and one-line description. Fetched live.

section?

get_page

Live markdown of one Flox doc page (the .md version). Accepts a slug like "concepts/environments" or "man/manifest.toml", or a full flox.dev/docs URL.

slug | url, max_chars?

search_docs

Keyword (BM25) search across Flox doc pages, fetched live and cached for about 10 minutes. Returns ranked passages with links.

query, limit?

list_guide_pages

Every page of this field guide with slug, title, group, summary and URL.

none

get_guide_page

Full markdown of one field guide page, e.g. pitch, objections, competitors-qa, security, competitive, economics, whiteboard/imageless-k8s.

slug

search_guide

Keyword search over this guide's sections. Returns passages with a deep link.

query, limit?

ask_guide

No LLM. Runs search_guide and search_docs together and returns the best passages with sources. Your own model writes the answer.

question, limit?

Claude Code

claude mcp add --transport http flox-field-guide https://flox.nixfred.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "flox-field-guide": {
      "url": "https://flox.nixfred.com/mcp"
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "flox-field-guide": {
      "type": "http",
      "url": "https://flox.nixfred.com/mcp"
    }
  }
}

Claude Desktop (via mcp-remote)

{
  "mcpServers": {
    "flox-field-guide": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://flox.nixfred.com/mcp"
      ]
    }
  }
}

Raw JSON-RPC

curl -s https://flox.nixfred.com/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_page","arguments":{"slug":"concepts/environments"}}}'

Notes