Knownset for developers / Private preview

Add trusted health context to your product.

Start with four read-only tools and made-up data. Each result is small, includes its sources, and cannot change a person's record.

Try a safe request Open the setup guide

CONNECTIONMCP 2026-07-28LOCAL SAMPLE4 READ-ONLY TOOLSHOSTED ACCESSBUILT / NOT OPEN

01 / Try one request

See the request, the checks, and the result.

Choose a tool below. The animated sample shows what happens before a read-only answer reaches your product.

REQUEST

Get a short answer with its sources attached.

The sample returns a readiness summary for one day without exposing raw provider files.

{
  "name": "knownset_get_health_summary",
  "arguments": {
    "date": "2026-08-08"
  }
}

01
Check access
Confirm the app and user are allowed to make this read.
02
Read approved data
Select only the records the person agreed to share.
03
Attach sources
Keep the evidence and known limits with the answer.
04
Return a small result
Send only what this request needs. Nothing is changed.

CHECKS RUNNING

{
  "status": "checking request"
}

Knownset is checking the request before returning any data.

READ ONLYSOURCES INCLUDEDNO WRITE

Step 1: Check access

02 / Setup guide

Run all four sample tools on your computer.

You need private-preview repository access, Node 22, Corepack, and Docker. These commands start the made-up environment and run the included client against the protected tool server.

01
Install the workspace
Corepack uses the exact pnpm version pinned by the repository.
02
Start the sample platform
The local controller waits until the database, sign-in, services, and made-up data are ready.
03
Approve the sample data
The command asks for an explicit --yes before it turns on access for the fixed demo member.
04
Run the included client
The client signs in, finds four tools, and follows one insight back to its sources.

LOCAL / PRIVATE PREVIEWNODE 22 + DOCKER

corepack pnpm install
corepack pnpm local:up
corepack pnpm --filter @knownset/mcp example:activate-local-demo -- --yes
corepack pnpm --filter @knownset/mcp example:local

WHAT SUCCESS LOOKS LIKE

All four reads finish and the evidence links back to the sample sources.

03 / Tool reference

Four tools work today. Three more are clearly marked as planned.

Each row starts with what the tool does in plain language. Open the technical description when you need the exact contract wording.

01

knownset_get_capabilities

See what this app is allowed to use

Lists the Knownset features available to the signed-in person without turning anything on.

Read the technical contract description

List only the Health and Coach surfaces available to the authenticated member. Does not activate any capability.

Works in previewRead onlyknownset:capabilities:read

02

knownset_get_health_summary

Get a health summary for one day

Returns a small, source-backed summary without exposing raw provider files or private internal analysis.

Read the technical contract description

Return a bounded, cited health summary for one date. Raw provider payloads and private analysis results are excluded.

Works in previewRead onlyknownset:health:read

03

knownset_list_health_insights

List the current insights worth showing

Returns a limited page of safe insight cards for one date and part of the product.

Read the technical contract description

List safe, current Insight cards for one date and surface with bounded pagination.

Works in previewRead onlyknownset:health:read

04

knownset_get_insight_evidence

Show the sources behind an insight

Returns the citations and known limits already attached to one insight for the signed-in person.

Read the technical contract description

Return the safe citations and limitations already attached to an Insight owned by the authenticated member.

Works in previewRead onlyknownset:health:read

05

knownset_ask_coach

Ask a coaching question

Would return a source-backed answer without applying a suggested action. This tool is not available in the preview.

Read the technical contract description

Ask a bounded coaching question and receive a cited answer. This tool never applies a proposed action.

Planned onlyRead onlyknownset:coach:ask

06

knownset_create_action_proposal

Prepare a change for someone to review

Would create an unconfirmed suggestion and hand it back to the product for review. It cannot approve or apply the change.

Read the technical contract description

Create an additive, unconfirmed proposal and return a first-party review handoff. Does not confirm or apply it.

Planned onlyCreates an unconfirmed requestknownset:proposal:create

07

knownset_request_data_export

Start a private export request

Would send the person to a first-party export flow without placing the export inside an AI conversation.

Read the technical contract description

Create a first-party export handoff. The export itself is never returned to the model context.

Planned onlyCreates an unconfirmed requestknownset:export:request

04 / Who can read what

Your server—not the AI—chooses whose data can be read.

Identity and permission are checked before a tool reads anything. The AI client cannot switch the organization, person, or approved purpose.

The person signs in and approves access for this product.
Knownset checks that the request is valid, current, and still allowed.
The server—not the AI—selects the organization and person.
A short-lived server credential reads only the approved data.
The result includes only what is needed, with sources and an audit record.

05 / Availability

See what you can use today.

The private preview starts locally. Hosted access and write-capable tools remain closed.

Surface	Current state	Boundary
Local sample platform	Available in private preview	Run the complete made-up environment on your computer, including sign-in, tools, logs, backup, and rollback.
Four read-only tools	Working locally	Read capabilities, a daily summary, current insights, and the sources behind one insight.
Hosted connection	Built / not open	Hosted access stays closed until staging, rollback, security review, and owner approval are complete.
Coaching, action, and export tools	Planned contract only	These tools are documented for future work but cannot be discovered or called in this preview.

06 / Private preview

Tell us what you want to build before access is opened.