# Upgrade prompts for Custom Agent tools in Notion MCP By Steven Van · 2026-09-01 Notion MCP's Custom Agent tools — notion-list-agents, notion-search-agents, and the session tools — now return a prompt with a recovery link when… Notion MCP's Custom Agent tools now explain how to fix broken access instead of just failing. [Notion]()'s [September 1 changelog entry]() covers notion-list-agents, notion-search-agents, and the Custom Agent session tools. - If a workspace lacks access to Notion AI and Custom Agents, these tools now return a prompt with a recovery link instead of a generic permission error. notion-fetch with the id self reports the tools as upgrade\_required with an upgrade\_url, or as plan\_required with a landing\_page\_url and landing\_page\_action, so a client can route around unavailable tools before calling them. - Workspaces with a billing restriction, such as an unpaid invoice, are handled separately: the tools return a permission error asking a workspace owner to manage billing, and current\_tool\_access reports them as not\_enabled rather than upgrade\_required. - A connection that lacks the "View threads and interact with agents" capability does not advertise these tools at all, and must reconnect or re-authorize to get them. [![]()]() ![Notion]() Notion All-in-one workspace for notes, docs, projects, and wikis — with AI built in for writing, summarizing, and organizing. [View Notion →]() Sources [Original source]() [Read Upgrade prompts for Custom Agent tools in Notion MCP on Creators Toolbox]() --- Canonical source: https://creatorstoolbox.com/blog/notion-upgrade-prompts-for-custom-agent-tools-in-notion-mcp