Repository navigation
Support for OpenAI Apps SDK #1465
Description
Description
OpenAI released their Apps SDK this past Monday along with an example repo for implementing this in FastMCP.
The example repo required creating custom handlers in order to support the _meta field that the Apps SDK depends on in several places. This field is part of the protocol, but not handled via the SDK.
This issue is to consolidate the features and existing PRs that are necessary for full support.
- Add Meta to Tool Definitions feat: add tool metadata in FastMCP.tool decorator #1463
- Allow Meta to be returned in Tool Call payloads Allow CallToolResult to be returned directly to support _meta field for OpenAI Apps #1459
- Add Meta to Resource Definitions
References
https://developers.openai.com/apps-sdk/build/mcp-server
https://github.com/openai/openai-apps-sdk-examples/blob/main/pizzaz_server_python/main.py
Activity
alexanderreiff commentedon Oct 13, 2025
I took inspiration from #1459 and implemented a similar solution for the resource
_metaneeds: #1476maxisbey commentedon Feb 20, 2026
All three items in this tracking issue are now implemented:
Full OpenAI Apps SDK support is in place. Resources, resource templates, and tools all support
_metathrough the FastMCP decorator (metaparameter) and wire format (Field(alias="_meta")).AI Disclaimer