Liminality · Connected

You're in.

Here is your key, then three short steps to connect it and run your first solve.

Use it in three steps

Step 1

Connect Liminality to your client

Pick the client you use. Your key is already filled into the command, so you can copy and paste as is.

  1. Open your terminal and run:
    claude mcp add liminality --transport http https://liminality.physea.ai/mcp --header "X-API-Key: YOUR_KEY"
  2. Start Claude Code and ask it to use Liminality.

How you know it worked: run claude mcp list and you see liminality with a connected check.

  1. Click to install, it opens Cursor with the server prefilled:
  2. Or add it by hand in ~/.cursor/mcp.json:

How you know it worked: Cursor Settings → MCP shows liminality with a green dot and its tools listed.

  1. One-click install, then approve when VS Code asks:
  2. Or add it by hand in .vscode/mcp.json:

How you know it worked: the MCP panel lists liminality as running, with its tools underneath.

  1. Add a remote / HTTP MCP server pointing at:
    https://liminality.physea.ai/mcp
  2. Set the auth header X-API-Key to:
    YOUR_KEY

How you know it worked: your client lists the liminality tools after it connects. The handshake and the tool list are always free.

Step 2

Run your first solve

Two ways to do it. Both use the same key.

  1. From your agent. Just ask it in plain language:
    Use Liminality to send a weekly digest email from our git activity.
  2. Or call the API directly:
    curl -X POST https://liminality.physea.ai/reduce \
      -H "Content-Type: application/json" -H "X-API-Key: YOUR_KEY" \
      -d '{"question": "send a weekly digest email from our git activity"}'

What you get back: the request reduced into its real sub-questions, each grounded to a tool, and the route that runs. A solve is one request start to finish. The back and forth inside it never bills.

Step 3

Keep going

The first 3 solves on your key are free. The same key keeps your library, so the more you solve, the more routes you can reuse. When you want more solves, buy a pack.

Stuck on anything? Email [email protected] and we will get you running.