CloudEffects
API Reference

MCP (reading from AI tools)

Connect the AI tool you use through MCP, and it can read your company's knowledge and strategy. It cannot write.

API Reference4 pages
Contents4 chapters

Connecting

  • Endpoint: /mcp on the OS iXanagi API address
  • Authentication: an API key, or approval from the AI tool (OAuth). An OAuth connection is allowed to read only.
  • One request, one answer. There is no long-lived stream.

The connected AI can read only what that key (or the approving account) can see.

Available tools

  • knowledge_search — Searches a brand's knowledge by meaning.
  • knowledge_fetch — Reads a brand's knowledge for a given topic.
  • knowledge_graph — Follows relations from one piece of knowledge to the ones connected to it (1–3 hops).
  • brand_context — Reads the brand's context: voice, company information, the customers it serves, and more.
  • platform_knowledge — Reads knowledge about how OS iXanagi itself works.
  • strategy_theses — Lists the brand's strategic positions (theses), or reads one.
  • outcome_summary — Reads a summary of the site's outcomes (sign-ups and so on) over a period.
  • growth_stage — Reads how far the brand's knowledge has grown (its growth stage).
  • list_brands — Lists the brands this key can see, with their sites.
  • get_object — Reads a single object by its identifier.

Common inputs

  • brand_key — which brand's knowledge to read. Searches and reads always stay inside one brand.
  • group_keys / auto_detect — name the topics to read, or let them be found from your words.
  • thesis_key — to read a single strategic position.
  • site_key / window_days — for outcome summaries: which site, and how many days (1–90).

Read-only

Only read operations are available over MCP. An operation is listed only when it has been explicitly marked for reading; anything else is refused as unknown. No other company's data can be read.

API Reference

Read next

Authentication and API keys

API Reference

Read

API overview

API Reference

Read
MCP (reading from AI tools) | CloudEffects