What this is

flatland-setup is a one-command installer that wires the Flatland MCP server into your AI coding tools. It validates your API key, verifies the MCP endpoint is reachable, configures Claude Code and Cursor, and confirms the live connection works — 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

| Tool | Config path | What gets written | |------|-------------|-------------------| | Claude Code | Managed via claude mcp add | A flatland MCP server entry at user scope | | Cursor | ~/.cursor/mcp.json | An HTTP MCP server pointing at api.flatlandfi.com/mcp/ |

Both entries carry your X-API-Key header. No other files are touched.

Commands

npx flatland-setup <API_KEY>   # install and verify
npx flatland-setup --verify    # check existing config and live connection
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 MCP endpoint is responding, 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.