∇ProvenDecisions
Ctrl K

API and MCP server

Use ProvenDecisions from your own programs and from AI assistants. The API takes a model as typed math or LaTeX and returns the answer as JSON; the MCP server gives the same solver to Claude and other assistants, so they quote checked numbers instead of guessing. Both are included in the Standard and Pro plans. Full examples are on the Developers page.

Plans that include it

Getting a key

  1. Sign in and open Settings.
  2. Under API keys, type a name (for example "laptop script") and choose Create key.
  3. Copy the key at once: it is shown only once. We keep only a scrambled copy (a hash), so nobody, not even us, can show it again. If you lose it, revoke it and make a new one.

You can have up to 5 keys at a time. Revoke stops a key at once. Keys are personal: do not share them or put them in public code.

What you can send

What comes back

The same answer as the app: the solver's status, the objective, the solution, the check of every constraint, the dual or KKT check, the proof label (for example "Exactly proven optimal"; see Reading an answer) and the walkthrough steps at the depth you ask for (1 to 10). Separate calls give the dual of a linear program and the KKT (Lagrange multiplier) certificate of a smooth problem.

For an MCP assistant the tools are solve, dual, kkt and explain (the walkthrough as text).

Connecting from claude.ai

On claude.ai and in the Claude apps you connect by signing in, with no key to copy:

  1. In Claude, open Settings, then Connectors, and choose Add custom connector.
  2. Name it ProvenDecisions and enter https://proven-decisions.ai/mcp. Keep the choices Claude marks Detected: Sign in now (Authentication) and Register automatically (OAuth client). Add no request headers and leave Advanced closed.
  3. Choose Connect. A ProvenDecisions page opens; sign in if asked.
  4. It asks: "Allow Claude to use ProvenDecisions on your account?" Choose Allow, and you are back in Claude with the connector on.

The same plans (Standard and Pro), limits and typed-math rule apply as for a key. Claude stays connected while you use it (its access renews by itself; after 30 days without use, connect again). Under Settings, Connected apps you see each connected app, when it was connected and last used; Disconnect stops it at once. On a Claude Team or Enterprise plan, an owner adds the connector for the organization first. Claude Desktop can also use a key; see the Developers page.

Connecting from Claude Code

Claude Code (in the terminal or in VS Code) signs in the same way, with no key:

  1. In a terminal, run claude mcp add --transport http --scope user proven-decisions https://proven-decisions.ai/mcp (--scope user makes it available in every project). If the terminal says claude: command not found, install Claude Code's terminal command first with Anthropic's installer (see Claude Code's own setup guide).
  2. Start a new Claude Code session and type /mcp. Choose proven-decisions, then Authenticate.
  3. Your browser opens the ProvenDecisions page; sign in if asked and choose Allow. Claude Code shows "Authentication successful".

To use a key instead (for example on a server with no browser), add --header "Authorization: Bearer pd_live_..." to the command in step 1 and skip steps 2 and 3.

Reading the site's content

The API and the MCP server also read everything on the site, without a model call and without using up your solves:

The website's rules apply: a tutorial above your plan is listed as locked and not served (a Standard key reads Free, Student and Standard tutorials; Pro reads all), and the Daily Update covers the last 365 days, as for a signed-in user. Every endpoint, with examples, is in the API reference; programs can read the OpenAPI document.

Limits

API and MCP requests use the same limits as the website, counted together for your account. Solving: 5 requests a minute, 100 a day and 1,000 a month; one problem at a time; 10 minutes of solving a day; and the monthly 85% stop (see Plans and limits). Reading content: the lighter limit the website uses for searches, 30 requests a minute and 1,000 a day. A script cannot do more than you can in the app. When a limit is reached the API answers with code 429 and says which limit and when it resets.

Privacy

Requests are handled like problems typed into the app (see Privacy in plain words). Keys, and the sign-ins of connected apps, are stored only as a hash, with the date each was made and last used.

Try ProvenDecisions free: type, photograph or say an optimization problem; every answer is checked by a solver.

What do you want to optimize?

Type the math, describe it in words, snap a photo or say it. ProvenDecisions builds the model, solves it, checks it and walks you through it.

One constraint per line, or separated by commas. Add integer: x, y or binary: z for whole-number decisions. LaTeX works too.

Try: