Skip to Content

Your site as an agent app

SchemaX turns your site into an agent app: a hosted MCP server, one per project, that lets agent users in tools like Claude ask about your business and send you an inquiry. There is nothing to install on your site. The server is compiled from the same verified graph that powers your schema, so it answers only from facts that are actually on your pages.

It is a public surface, like your schema manifest. It carries no API keys and no agent-capability tokens.

What an agent user can do

The server exposes four read tools and one action tool:

ToolWhat it does
aboutReturns your business name, URL, and description from the grounded Organization on your site.
offeringsLists your products or services with the grounded name, description, and price where present.
hours_and_contactReturns contact details, opening hours, and address where they are grounded on the site.
askAnswers a free-text question by matching it against your verified facts.
send_inquiryCaptures a lead (name, contact, message, and an optional offering) and stores it for you.

Every read response carries its source, stamped with the date the content was last verified: site content, verified <date>.

The inquiry widget

When you approve it, send_inquiry is paired with an inquiry form that renders directly inside the agent: a real form in Claude or ChatGPT, not a wall of text. The form is generated from your graph: your business name, an offerings dropdown when you have products or services, and name, contact, and message fields. It is built with the MCP Apps  extension and submits back through the host, so the agent user confirms before anything is sent.

The trust guarantee

The read tools answer only from your auto-published, verified facts, the same set that goes into your JSON-LD. Anything still under review is withheld from the agent, exactly as it is withheld from your schema.

When a question has no grounded answer, the server does not improvise. It returns one exact sentence:

Not stated on the site.

This is the trust contract extended to conversation. An agent representing your business will give a verified fact or say nothing. It will not guess a price, a policy, or a phone number that was never on your page. In v1 there are no model calls in the answer path at all; ask is pure retrieval over your grounded content.

Connecting it in Claude

Each project has its own connector URL:

https://api.schemax.io/public/sites/<your-project-id>/mcp

An agent user adds that URL as a custom MCP connector in their client (for example, Claude’s connector settings). Once connected, they can call the tools above and, when you have enabled and approved the widget, see the inquiry form rendered inline.

The endpoint speaks the Streamable HTTP MCP transport. You do not run anything: it is hosted by SchemaX and deploys with the rest of your project.

What happens to an inquiry

A submitted inquiry is:

  1. validated, screened for spam (honeypot field plus a rate limit of 3 per hour per visitor), and stored as a lead you can read in your lead inbox;
  2. recorded as a goal completion in your outcome measurement, so an agent-driven lead shows up in your Outcomes screen.

Honest limits. Leads are stored and visible to you. They are not yet emailed or forwarded automatically. Outbound notification (email, Slack, or webhook when a lead lands) is a known follow-up, not a current feature. Plan to check your lead inbox until it ships.

Enabling it

The agent app is off by default. It serves publicly only after you turn it on for the project, and the inquiry widget serves only after you approve a specific compiled version of it, so a newer recompile does not auto-publish. This is the same rule as every SchemaX surface: a human approves anything that goes live.

Enable the server and approve a widget version from your project, then connect the URL above to confirm it end to end.

How it relates to the rest of SchemaX

  • Discover builds and verifies the graph the agent app answers from.
  • Outcome measurement records the leads the agent app captures.
  • The WordPress plugin is not needed for the agent app (it is hosted and install-free), but it delivers the other site-side surfaces.
Last updated on