---
id: post/gerardorenteria-blog/12682
type: post
title: "🤖 AboutText: Teaching AI to Understand Your APIs ✨"
summary: 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.
tier: community
language: en
tags:
  - api
  - abouttext
  - mcp
  - ai assistance
  - copilot studio
  - apiv2
  - self-documenting apis
system: integration
review:
  state: reviewed
  by: opus
  at: "2026-10-08T01:58:16.843Z"
  flags: []
generated:
  at: "2026-10-08T01:26:53.141Z"
  pipeline: 0.2.0
  prompts:
    extract-post: 1
  input_hash: 964a929c5d82371befe3d97a1d2ef0c50e9b3669da2316814a7dbf52b6e54cae
evidence:
  - kind: blog
    url: https://gerardorenteria.blog/2025/11/12/%f0%9f%a4%96-abouttext-teaching-ai-to-understand-your-apis-%e2%9c%a8/
    title: "🤖 AboutText: Teaching AI to Understand Your APIs ✨"
    date: "2025-11-12"
    commit: null
    t: null
    quote: null
  - kind: blog
    url: https://gerardorenteria.blog/2025/11/12/%f0%9f%a4%96-abouttext-teaching-ai-to-understand-your-apis-%e2%9c%a8/
    title: "🤖 AboutText: Teaching AI to Understand Your APIs ✨"
    date: "2025-11-12"
    commit: null
    t: null
    quote: APIs need to be self-explanatory for AI assistants.
  - kind: blog
    url: https://gerardorenteria.blog/2025/11/12/%f0%9f%a4%96-abouttext-teaching-ai-to-understand-your-apis-%e2%9c%a8/
    title: "🤖 AboutText: Teaching AI to Understand Your APIs ✨"
    date: "2025-11-12"
    commit: null
    t: null
    quote: AboutText = '[What it manages] + [What data it includes] + [What operations] + [What use cases] + [What integrations]'
links:
  learn: []
  objects:
    - object/page/30017
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
post_id: "12682"
source_id: gerardorenteria-blog
source_name: Gerardo Renteria
url: https://gerardorenteria.blog/2025/11/12/%f0%9f%a4%96-abouttext-teaching-ai-to-understand-your-apis-%e2%9c%a8/
published_at: "2025-11-12T15:46:48.000Z"
author: Gerardo Renteria
full_text: false
words: 603
quotes:
  - text: APIs need to be self-explanatory for AI assistants.
    why_it_matters: Explains the fundamental motivation for the AboutText property - making APIs discoverable and usable by AI systems
  - text: AboutText = '[What it manages] + [What data it includes] + [What operations] + [What use cases] + [What integrations]'
    why_it_matters: Provides the recommended structure for writing effective AboutText descriptions
code_objects_mentioned:
  - page APIV2 - Employees
systems:
  - integration
  - copilot
  - development
versions_mentioned:
  - "27.0"
  - "27.1"
preview:
  embeddable: true
  frame_url: https://gerardorenteria.blog/2025/11/12/%f0%9f%a4%96-abouttext-teaching-ai-to-understand-your-apis-%e2%9c%a8/embed/
  image: https://gerardorenteria.blog/wp-content/uploads/2025/11/minimalist-illustration-abstract-ai-brain-geometric-nodes-dark-purple-on-left-glowing-light-bea.jpeg
  image_alt: null
  image_w: 1024
  image_h: 1024
  site_name: Gerardo Rentería Blog
  favicon: https://gerardorenteria.blog/wp-content/uploads/2020/11/cropped-wolficon.jpg?w=32
  probed_at: "2026-10-07T11:51:42.906Z"
---

# 🤖 AboutText: Teaching AI to Understand Your APIs ✨

[Read the post](https://gerardorenteria.blog/2025/11/12/%f0%9f%a4%96-abouttext-teaching-ai-to-understand-your-apis-%e2%9c%a8/) · Gerardo Renteria (Gerardo Renteria) · 2025-11-12 · 603 words · tier community · reviewed (checked by Opus)

> 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.

## 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.

- [page 30017 "APIV2 - Employees"](../../objects/page/30017.md)

## 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.