Skip to main content

Docs

WebMCP for AI Agents

K‑Dense Web supports WebMCP, a proposed web standard that lets a page offer tools to AI agents running in your browser. Instead of reading screenshots and guessing where to click, an agent calls K‑Dense Web’s own functions: start a research session, follow it while it runs, read the report and output files, reply, and keep your sessions organized.

The tools run through the same code paths as the buttons you press, so credit checks, your default effort level, and attached files behave exactly as they would if you had clicked.

If you only read one thing

Sign in to K‑Dense Web in a browser that supports WebMCP, and your agent sees the tools for the page you are on. It can do the research work you would do yourself, but it cannot pay, share, delete, or change your account. Anything that spends credits is flagged so the agent checks with you first, and if you want the final say, ask it to draft the prompt rather than start the run.

What an agent can do

Each page offers only the tools that work on it, so the set changes as the agent moves through the app. Effort levels use the names you see on screen: instant, standard, and pro.

Anywhere in the app

Every page, once you are signed in.

get-app-state
Which page you are on, your credit balance, the most each effort level can cost, and which tools the page offers.
navigate
Open the research composer, an existing session, or your folders.
list-folders
Your folders, newest activity first, with session counts.
list-sessions
Your research sessions, filtered by title words or folder.

Starting research

The new-session composer.

search-resources
Find the skills and databases the research agents can be told to use.
search-workflows
Find ready-made workflows, such as reviewing a paper or drafting a grant proposal, and the inputs each needs.
draft-research-prompt
Fill in the composer without sending, so you review the prompt, attach files, and press send yourself.
start-research-session
Start a session at the effort level you chose. Spends credits, except at Instant effort.

Following a session

An open research session.

get-session-status
Whether the agents are still running, whether the planning agent is waiting on you, and where the final report is.
list-messages
The conversation so far, one short preview per turn.
read-message
The full text of one message, in pages.
list-session-files
The code, figures, data, and reports the run wrote, plus your uploads.
read-session-file
The text of a report, script, CSV, LaTeX, or log file, in pages. PDFs return their extracted text.
open-session-file
Show a figure, PDF, structure, notebook, or table to you next to the chat.
download-session-file
Save one file, or the whole session as a zip, through your browser's download.
send-message
Reply to the session: a follow-up, answers to the planning agent, or approval of its plan. Spends credits.
stop-run
Stop the agents. Progress so far is kept, and the session can continue later.

Organizing sessions

The folders page.

create-folder
Create an empty folder.
rename-session
Change a session's title.
move-session-to-folder
Move a session into another folder.

What stays with you

Some actions are irreversible, cross a security boundary, or only mean something coming from you. None of them are offered to agents:

  • Anything before you sign in
  • Payments and buying credits
  • Account, team, and member settings
  • Connectors and stored credentials
  • Sharing or publishing a session
  • Deleting sessions or folders
  • Feedback ratings

Safeguards

Spending is flagged

Starting a session, replying to one, and stopping a run are marked as consequential actions, and the agent is told what each effort level can cost so it can confirm with you first. If your balance does not cover a run, the tool says so and offers the effort levels that fit.

Output is treated as data

A report can quote a web page or paper that contains instructions aimed at an AI. Tools that return agent output or file contents are marked as untrusted content, so the agent reading them treats the text as data, not as commands.

You see what the agent does

The agent works in the same tab you do. Every action that changes something appears as a notice in the app, and if you have an unsaved edit open, the app asks you before an agent's page switch would discard it.

Incognito stays private

An agent forwards tool results to the AI model behind it. Incognito sessions promise that nothing outlives the visit, so the tools that read messages and files are not offered for them at all.

Using it

You need two things: a browser that supports WebMCP, and an AI agent that can use it, such as a browser’s built-in agent or an agent extension. WebMCP is a draft from the W3C Web Machine Learning Community Group, and browser support is still arriving, starting with Chrome.

Then open app.k-dense.ai, sign in, and ask your agent for the work in plain language: “start a Standard run that compares these two cohorts,” “tell me when the report is ready,” or “move my proteomics sessions into a folder called Grant.” A good first call for any agent is get-app-state, which reports where it is and what it can do from there.

Developers testing locally can enable chrome://flags/#enable-webmcp-testing and inspect the registered tools with Chrome’s Model Context Tool Inspector extension.