Skip to content

Add endpoint pattern examples to execute tool description#64

Draft
mattzcarey wants to merge 1 commit intomainfrom
fix/execute-tool-examples
Draft

Add endpoint pattern examples to execute tool description#64
mattzcarey wants to merge 1 commit intomainfrom
fix/execute-tool-examples

Conversation

@mattzcarey
Copy link
Contributor

Summary

  • Adds guidance that not all Cloudflare API endpoints follow the same pattern — some are top-level (e.g. /zones, /user) with query filters, others are nested under /accounts/{account_id}/
  • Adds two concrete examples: listing zones (top-level with account.id query filter) and listing Workers scripts (account-scoped)
  • Adds a note to always use the search tool first to find the correct endpoint path

Context

Another MCP client was hitting errors by using /accounts/{id}/zones instead of /zones?account.id={id}. These examples should help models pick the right pattern.

Test plan

  • Verify examples render correctly in tool description
  • Test that /zones with query filter works
  • Test that /accounts/{accountId}/workers/scripts works

Help models understand that not all Cloudflare API endpoints are
account-scoped. Some (like /zones) are top-level with query filters,
others are nested under /accounts/{account_id}/.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant