Quick start
One unauthenticated call returns the service description, the three products and every public endpoint.
curl https://henneth.ai/api/agent/discovery
What needs authentication
Henneth does not run an OAuth authorization server for third-party agents today, so there is no authorization or token endpoint to discover. Programmatic access above the anonymous rate limit uses an API key issued by email. When OAuth ships, its metadata will be published at /.well-known/oauth-protected-resource and documented here.
Anonymous·Nothing·Discovery, brand lookup, the sample report, health, and every page of this site as HTML or Markdown.
API key·Authorization: Bearer <key>, issued by email·The same endpoints at a higher rate limit. Write [email protected] with your agent name, intended use and expected volume. Customer data·A signed-in Henneth account at app.henneth.ai·Your own workspace: tracked prompts, competitor sets and reports. No anonymous or in-page tool reaches this.
HTTP API
Described by openapi.json and listed in the RFC 9727 API catalog. Every endpoint below is reachable without credentials.
GET
/api/agent/discoveryThis endpoint. Returns API overview and capabilities.GET
/api/agent/brands?query=<brand_name>Sample brand-visibility payload. Fixed values, identical for every brand, not a measurement. Example: /api/agent/brands?query=sephoraGET
/api/agent/reports/sampleReturns a sample agent visibility report with mock data to understand the response format.GET
/api/healthService health check.MCP server
Model Context Protocol server for Henneth: fetch agent-rendered pages and measure how AI assistants see and recommend brands. The server card at /.well-known/mcp/server-card.json carries the transport and auth details. The bearer token is issued on request.
streamable-http · https://mcp.henneth.ai/mcp
fetch_urlFetch a URL as agents see it: JS-rendered page capture plus extracted robots.txt policy signals.
search_wikipediaSearch Wikipedia for entity grounding of a brand or company.
Browser tools
An agent driving a browser that supports WebMCP gets these tools on page load, with no click or scroll needed. They read the same public pages a visitor sees and never touch account data. Requesting a demo opens the form for a person to fill in; no tool here submits it.
get_platform_overviewGet an overview of Henneth: what the company does and the three products (Lens, Prism, Playbooks) with a canonical link for each. Start here when asked what Henneth is.
get_product_detailsGet the description and canonical link for one Henneth product. Accepts lens, prism or playbooks.
search_public_docsSearch the public Henneth pages and return matching titles, snippets and canonical links. Covers products, documentation and company pages. Returns an empty list when nothing matches.
open_demo_requestGet the link to the Henneth demo request form. This only returns the URL for a person to open and fill in; it does not submit a request or book anything.
Markdown pages
Any page of this site returns Markdown instead of HTML when you ask for it, so there is no need to parse the markup.
curl -H "Accept: text/markdown" https://henneth.ai/lens
Discovery files
/.well-known/api-catalogRFC 9727 linkset pointing at the spec, docs and health.
/openapi.jsonOpenAPI 3.1 description of every public endpoint.
/.well-known/mcp/server-card.jsonMCP server card: transport, auth and tools.
/.well-known/agent-skills/index.jsonSkill index with a SHA-256 per skill file.
/.well-known/ai-catalog.jsonARD manifest with representative queries per capability.
/auth.mdHow to get credentials, in Markdown.
/robots.txtCrawl policy and content signals.
/sitemap.xmlEvery indexable page.
Skills
Agent skill files, each listed with a SHA-256 in the index so you can verify what you loaded.
brand-visibility-scoreFetch the sample brand-visibility payload from the Henneth agent API. Fixed sample values, not a measurement of the brand you ask for.
sample-visibility-reportFetch a complete sample agent-visibility report to learn the response format before requesting full access.