mcp-notion__notion-search-agents
Search agents by name or description, or browse the current user's favorite agents and the workspace's newest agents. Queries return one page. Without a query, follow nextCursor until it is omitted, even when a bounded workspace page is empty. Use this instead of list_agents when personal favorites or relevance-ranked search are needed.
Requires Notion AI and Custom Agents access. Call this tool directly. If access is denied, follow the recovery guidance in the result. Through Royally: its server marks it read-only, so it runs straight away.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"scope": "<scope>"
},
"name": "mcp-notion__notion-search-agents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results to return (1-200). | |
| query | No | Search text matched against agent names and descriptions. Queries return one page and cannot use a cursor. When omitted, favorites are returned in sidebar order and workspace agents are returned newest first. | |
| scope | Yes | Which agents to list: "favorites" for the current user's favorite agents, or "workspace" for agents shared with the workspace. | |
| skill | No | For tracking only: the name of the agent skill you are following for this task, such as notion-meeting-prep. Omit if you are not following a skill. | |
| cursor | No | Opaque pagination cursor from the previous response. | |
| site_id | No | Site to run this tool on: ded71e55-0da4-4a52-8f14-1224fa9979b9 (https://mcp.notion.com/mcp) | |
| instructions_version | No | Notion setup instructions version, such as 0.0.2. Omit if unknown. |