---
title: "Demo Solve"
method: POST
path: "/demo/solve"
---

# Demo Solve

`POST /demo/solve`

## Request

- Base URL: `https://mcp.physea.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.physea.ai/demo/solve`
- Auth: none declared

Keyless, IP-rate-limited preview for the physea.ai/mcp hero. Returns the
STRUCTURAL result — the reduction (objective + the definitive sub-questions
the request breaks into) — NOT a full deep synthesis. The structural artifact
is the real wedge per the conversion audit, and it's cheap + abuse-resistant
(one model call at a shallow depth, cache bypassed so demo traffic never
writes to the shared path-DB).

Reuses the existing solve path (reduce.reduce_oneshot + reduce.to_digest) at
low depth; invents no new engine. Over the per-IP cap -> 429 with a message
the hero shows. Lives outside the /mcp key gate (see the module note above).

## Request body

- DemoSolveRequest
  - `question` string, required
  - `mode` 'auto' | 'solve' | 'decide' | 'research' | 'plan'
  - `context` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/physea/apis/liminality-router-service.md) · [All operations](https://skmtc.dev/physea/apis/liminality-router-service/llms.txt) · [OpenAPI document](https://skmtc.dev/physea/apis/liminality-router-service/revisions/5f60ddd97544?raw)