docs(mcp): add note regarding the dynamic tool discovery logic based on client capabilities

[MQ37]

close: #1974

[apify-service-account]

Preview for this PR was built for commit 32a462b and is ready at https://pr-1973.preview.docs.apify.com!

[TC-MO]

We definitely cannot have two admonitions next to each other, it visually way to distracting and just not a good practice. But I think I may have a solution (tho a little more involved)

What are your thoughts about doing a slight reshuffle of the order of headings. I would propose the following

Available tools

Table

get-actor-output admonitions

Dynamic tool discovery (as it to me feels like a extension of all available tools)

All of it's content

Dynamic tool discovery admonition

Thoughts @jirispilka @MQ37 ?

[apify-service-account]

Preview for this PR was built for commit 03296f35 and is ready at https://pr-1973.preview.docs.apify.com!

[jirispilka]

@TC-MO thanks for the suggestion. I decided to fix it right away based on it. Please check it out. Thanks

[TC-MO]

Thanks! I think you've left accidentally first Dynamic tool discovery heading & content

Also what do you think about making Dynamic tool discovery H4?

[apify-service-account]

Preview for this PR was built for commit be13f96b and is ready at https://pr-1973.preview.docs.apify.com!

[jirispilka]

oh, right, thank you!

[TC-MO]

Yeah i think it works much better, thank you!

[TC-MO]

LGTM