Connect one public MCP endpoint from a compatible agent client. Qelly validates a bounded
scenario, runs the deterministic synthetic portfolio kernel, and returns a signed run
reference under the same reproducible evidence contract.
The public endpoint proves the interaction contract. Private portfolio work and learned
world models remain behind the controls and evidence they require.
LIVE / SYNTHETIC
Public Portfolio MCP
A bounded, unauthenticated product proof with one synthetic portfolio, deterministic
calculations, signed run references that expire within 60 minutes, text results, and a
read-only embedded view.
No holdings upload. No Qelly Event Markets key. No portfolio-specific model training.
NEXT / PRIVATE
Governed portfolio workspace
OAuth, tenant-scoped access, encrypted uploads, immutable portfolio snapshots,
approvals, and audit records come before real holdings or continuous workflows.
RESEARCH
Event-conditioned world models
Event-conditioned financial world models remain a research program for separating
branch probability, financial consequence, and decision robustness.
Portfolio-specific training begins only after OAuth, tenant isolation, and approved
private-holdings ingestion. It is not part of the public endpoint.
OUT OF SCOPE
Consequential authority
Qelly does not provide investment advice, trade execution, custody, or a self-approved
recommendation. Every decision artifact remains analysis for human review.
PROVIDER-NEUTRAL FLOW
The conversation changes. The calculation does not.
The agent interprets and explains. Qelly validates, calculates, signs, and returns the
evidence.
01 / ListDiscover the bounded synthetic portfolio.
02 / CompileTurn a quantified premise into explicit factors.
03 / ReviewInspect units, ranges, warnings, and assumptions.
04 / RunEvaluate only the reviewed scenario.
05 / RetrieveReopen the signed decision artifact.
06 / CompareInspect bounded actions and residual downside.
TOOL MANIFEST
Five tools, each with one bounded job.
There is no database query, code-execution, upload, account, or trading tool on the public
surface.
list_demo_portfoliosReturn the available synthetic case and its declared coverage.
compile_scenarioCompile supported quantified language into a reviewable factor scenario.
run_stress_testEvaluate the reviewed scenario with the deterministic synthetic kernel.
get_runVerify a Qelly-signed reference and reconstruct the same result.
compare_candidate_actionsExpose ranking stability, trade-offs, constraints, and residual downside.
STARTER PROMPTS
Make the review step visible in the conversation.
These prompts use the same five bounded tools. Start with compilation, inspect the
assumptions, and run only after review.
01 / Compile and pause
“Use Qelly Portfolio Demo. List the synthetic portfolio, compile the
higher-for-longer preset, and stop so I can inspect every factor, unit, and warning.”
02 / Run after review
“Run only the reviewed scenario. Explain the loss attribution and distinguish scenario
severity from probability.”
03 / Retrieve and compare
“Retrieve the signed run, compare all bounded candidate actions, and explain residual
downside without presenting investment advice.”
The browser-local demo and remote agent endpoint have different execution boundaries, so
Qelly states both explicitly.
SENT TO THE PUBLIC ENDPOINT
Bounded synthetic tool inputs
Only bounded synthetic scenario inputs are sent to Qelly when an agent calls the
remote MCP endpoint. The public endpoint is stateless and its analysis is
non-persisting.
Its short-lived run reference is signed for integrity, not encrypted. Never place
confidential information in a public-demo premise.
NOT ACCEPTED
No private portfolio channel
The public surface does not accept uploads, real holdings, credentials, or Event
Markets keys. It cannot connect a brokerage, monitor a live portfolio, or train a
portfolio-specific model.
Authentication and governance come before personalization.
OAuth, tenant isolation, encrypted uploads, real holdings, governed approvals, continuous
monitoring, and subscriptions are the next authenticated layer—not capabilities of this
public demo.
CONNECT
Choose a host. Keep the same Qelly boundary.
Provider controls and plan eligibility change. These concise setup notes render the
checked-in guides without claiming a capability a host has not documented.
HOST GUIDE
ChatGPT
services/portfolio/docs/agents/chatgpt.md
Open the supported custom-app or developer-mode controls for your workspace.
Add https://www.qelly.ai/demo/mcp with no authentication.
Confirm the five synthetic tools, then ask Qelly to compile and pause for review.
HOST GUIDE
Claude
services/portfolio/docs/agents/claude.md
Open remote custom-connector settings on a supported Claude plan.
Add the public endpoint with no authentication and inspect the discovered tools.
Request scenario review before Qelly runs or compares the synthetic actions.
HOST GUIDE
Kimi-compatible developer clients
services/portfolio/docs/agents/kimi.md
Consumer Kimi custom-connector support is not yet claimed. Wave A targets Kimi Code
and verified Kimi-compatible developer clients.
Add a remote Streamable HTTP MCP server in a compatible developer client.
Use the public endpoint without a credential and review tool permissions.
Use text and structured results when the host does not render the embedded app.
PORTABLE CONTRACT
MCP and other agents
services/portfolio/docs/agents/mcp.md
Connect over remote Streamable HTTP and negotiate a supported 2025 MCP version.
Use text-first tools and structured content as the canonical portable result.
Keep Event Markets credentials and private holdings outside this public surface.
PRODUCT BOUNDARY
Portfolio and Event Markets remain deliberately separate.
Qelly Event Markets has a separate product, data, session, and authorization boundary.
Its API key is not a Portfolio credential and should never be pasted into this endpoint.
Start with synthetic evidence. Add private data only after the controls exist.
Connect the public endpoint, inspect every assumption, and keep a human in the decision
path. For a governed private pilot, define the portfolio workflow and approval boundary
first.