BC Observatoryunofficial, made by waldo
community postIntegration & APIscommunity - not Microsoftreviewed - checked by Opus

🤖 AboutText: Teaching AI to Understand Your APIs ✨

The AboutText property, added to APIV2 pages in Business Central 27.1, allows APIs to describe themselves to AI assistants. When APIs are exposed through the Model Context Protocol (MCP), this property tells AI systems what the API manages, what data it includes, what operations it supports, and what use cases it enables, helping AI assistants decide when to use the correct API.

Open in Claude12682.md

post Gerardo RenterĂ­a Blog

Gerardo Renteria ¡ 2025-11-12 ¡ 603 words ¡ about 3 min

"APIs need to be self-explanatory for AI assistants."
Show the post hereRead on Gerardo RenterĂ­a Blog

Key points

  • AboutText is a new property in BC 27.1 for APIV2 pages that describes API functionality to AI systems
  • The property appears as a tool description in Copilot Studio when reading MCP configuration
  • AI assistants read AboutText to determine which API to use when responding to user requests
  • Best practice structure includes what the API manages, what data it includes, operations supported, use cases, and integrations

Quotes

  • “APIs need to be self-explanatory for AI assistants.” (Explains the fundamental motivation for the AboutText property - making APIs discoverable and usable by AI systems)
  • “AboutText = ‘[What it manages] + [What data it includes] + [What operations] + [What use cases] + [What integrations]’” (Provides the recommended structure for writing effective AboutText descriptions)

AL objects mentioned

As named in the post. A name that matches one object page by exact type and name links to it; the others stay as named.

Context

  • Features: AboutText property, Model Context Protocol (MCP), API self-documentation, Copilot Studio integration, APIV2 pages
  • Versions: 27.0, 27.1

Source: Gerardo Renteria, community blog. Summary, key points and quotes are derived (CONTENT-NOTICE.md); read the original for the full text.