Skip to main content

Build integrations · Public

Model Context Protocol (MCP)

Connect AI agents to ONE Help — search articles and fetch full guides through the MCP server.

Skyfallen ONE Help is available in a browser and to AI agents through the Model Context Protocol. MCP lets an agent search this site, read an article in full, and answer questions with the same source material you see here.

What the server exposes

ONE runs a dedicated MCP server called ONE Help. It registers two tools:

Management-only articles (such as internal ONE Pass references) are not returned through MCP. Public and partner articles are.

Typical flow for an agent:

  1. Call search-help-docs with a short query.
  2. Pick the best slug from the results.
  3. Call get-help-doc when the full article text is needed.

Pass locale as en or tr on either tool to search or read Turkish help content. When omitted, English is used. Turkish articles use the same slugs as English; only titles, summaries, categories, and body text change.

Tool Purpose
search-help-docs Find public help articles by keyword, with optional category filtering.
get-help-doc Return the markdown body for a single article slug.

Web endpoint

Remote MCP clients connect over HTTP on the application domain:

The endpoint accepts MCP POST requests.

https://skyfallen.one/mcp

Tool reference

search-help-docs

Search titles, summaries, categories, slugs, and article bodies.

Argument Required Description
query Yes Keywords such as CAS session, passkey, or webhook.
category No Restrict to a catalogue group, such as Getting started or Build integrations.
limit No Maximum matches to return. Defaults to 10, capped at 25.
locale No Help catalogue language: en or tr. Defaults to en.

Example result shape:

JSONRepresentative JSON response; production objects can include more fields depending on the endpoint and privileges.
{
  "query": "tenant branding",
  "locale": "en",
  "count": 1,
  "results": [
    {
      "slug": "guides/branding",
      "title": "Brand your sign-in and portal",
      "summary": "Set sign-in copy, default language, portal text, logo, and background image before members see the workforce experience.",
      "category": "Workforce identity",
      "url": "https://help.skyfallen.one/guides/branding"
    }
  ]
}

get-help-doc

Fetch one article by slug.

The response includes metadata plus the raw markdown body — the same source rendered in the browser.

Argument Required Description
slug Yes Path from search results or the help URL, such as apis/cas.
locale No Help catalogue language: en or tr. Defaults to en. Match the locale used in search-help-docs when fetching a result.

When to use MCP instead of the site

Use the website when you are reading sequentially or sharing a link with a colleague. Use MCP when an agent needs to:

  • Look up an API field or error code while editing integration code.
  • Compare CAS and SAPP behaviour without opening several tabs.
  • Draft runbooks that must match the current help text.

MCP search is keyword-based. For a known article, call get-help-doc directly with its slug.

Support

Request Help

Open a Skyfallen ONE support request for your organisation and continue the conversation in Success Manager.

Open a request
English