What this is

flatland-setup is a one-command installer that wires the Flatland durable local client into your AI coding tools. It validates your API key, configures Claude Code and Cursor to run the local client, and confirms it launches — in about five seconds.

You don't use this package directly. Your agent does.

Quickstart

Get a key at flatlandfi.com, then:

npx flatland-setup fl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

That's it. Open a new Claude Code session and ask:

"Build me a 3-year P&L for a DTC coffee brand doing $40K/mo in revenue with 65% gross margins."

What it configures

It installs the durable local client (flatland-client): a small stdio MCP server that runs on your machine, holds your model IR locally (~/.flatland/models/, survives sessions/restarts), and routes compute to the hosted /api/v2 engine. Your model is a file you own.

| Tool | Config path | What gets written | |------|-------------|-------------------| | Claude Code | Managed via claude mcp add | flatland → npx -y flatland-client mcp | | Cursor | ~/.cursor/mcp.json | flatland → command: npx, args: [-y, flatland-client, mcp] |

Your key is saved once to ~/.flatland/config.json (owner-only 0600) and read from there by the client — it is not embedded in the MCP config files.

Flatland is durable-by-default and there is no stateless / no-persistence path. The old hosted MCP proxy (api.flatlandfi.com/mcp) has been retired (it now returns HTTP 410); all compute goes through the durable local client → the hosted /api/v2 engine.

Commands

npx flatland-setup <API_KEY>              # install the durable client
npx flatland-setup --verify              # check existing config and that the client launches
npx flatland-setup --uninstall           # remove Flatland from Claude Code + Cursor

Prerequisites

• Node.js 18 or later (for global fetch)
• Claude Code or Cursor — at least one
• A Flatland API key (get one)

Troubleshooting

npx is running an old version. npx caches aggressively. Force the current release with:

npx --yes flatland-setup@latest <API_KEY>

Tools don't show up in Claude Code after install. Start a new Claude Code session — MCP servers are only loaded at startup. Run /mcp inside Claude Code to confirm the flatland server is connected.

Live connection test didn't confirm. This is usually a network hiccup during the end-to-end probe, not a real failure. If --verify shows the key is accepted and the durable client launches, Claude Code will work.

Something else. Run npx flatland-setup --verify for a structured report, then email [email protected].

What is Flatland

A financial modeling engine for AI agents. Typed computation graphs, assertions, scenario analysis, sensitivity tables, and Excel export — exposed over MCP so your agent can build, compile, and analyze models without leaving the chat.

• Docs: flatlandfi.com/quickstart
• Homepage: flatlandfi.com
• Pricing: $35/mo, 14-day free trial
• Contact: [email protected]

License

The flatland-setup installer is released under the MIT License. This covers the installer code only — the Flatland engine and API are a separate, proprietary service accessed with a paid API key.