Unl MCP server

Unl

Unl, your why agent. Your AI already knows how to reason. Unl gives it your reason.

See it work in two minutes, no account: node demo/changed-decision.mjs

You decide things while you work with AI: what to build, what to leave out, and why. Unl keeps those decisions with their reasons. When you or one of your agents is about to act, Unl hands over the ones that bear on the task, so Claude Code, Cursor, ChatGPT, Codex and the agents you build all start from the same why. You never re-brief them.

What is open, and what is hosted

Open, in this repository, under MIT: everything that runs on your side. The unl command, the AI SDK package, the Cursor plugin, a working example for each agent framework, and the decision format with a conformance check you can run on your own code. Read them to see exactly what leaves your machine.

Also open: the status checks, which test Unl from outside its own infrastructure.

Hosted: Unl itself, the service that keeps your decisions with their reasons and chooses which ones bear on a task, runs at api.unlimitless.ai. Its code is not in this repository.

Start

With the agent you already use, tell it:

Read unlimitless.ai/start.md, set up Unl, and show me the decisions you find.

In Claude Code or Cursor:

npm install -g unlimitless
unl              # sign in once, then the Unl terminal opens
unl init         # in your project, for Claude Code (add --cursor for Cursor)

Then ask your agent what you are working on.

In any MCP client (ChatGPT, Claude, Codex, VS Code, Grok Bot, Lovable): add the server https://api.unlimitless.ai/mcp and sign in when it asks.

In an agent you build: make a key at unlimitless.ai/portal/keys, set it as UNL_KEY, and pick your framework below.

Connect your tools

Every tool uses the same address, https://api.unlimitless.ai/mcp, and signs in with OAuth once. There is no key to paste: a personal key is only for the API, never for connecting a tool.

Claude and Claude Desktop. Open Settings, then Connectors, and choose Add custom connector. Name it Unl, paste https://api.unlimitless.ai/mcp, and add it.

Claude Code. In your project, unl init signs you in and wires the hook that brings Unl into every turn. To add only the server:

claude mcp add --transport http unl https://api.unlimitless.ai/mcp

then run /mcp, choose unl and pick Authenticate.

ChatGPT. In Settings, open Plugins and switch on Developer mode. Choose New Plugin, name it Unl, paste https://api.unlimitless.ai/mcp as the server URL, set authentication to OAuth and keep Dynamic Client Registration. Then open Advanced OAuth settings and untick OIDC enabled: left on, ChatGPT asks for a scope Unl does not register and the connection is refused.

Cursor. Add the URL to .cursor/mcp.json, no key and no header, or install the Cursor plugin in this repository:

{ "mcpServers": { "unl": { "url": "https://api.unlimitless.ai/mcp" } } }

Everything else (Codex, VS Code, Antigravity, Grok Bot, Lovable, Viktor and more): step-by-step for each, kept current, at unlimitless.ai/connect.

What is here

Shortened. The full README is on GitHub.