docs: AGENTS.md (or CLAUDE.md) is redundant and duplicates context (at least in Cursor)

[ViaAnthroposBenevolentia]

In the usage section of the docs it is advised to add MCP server's description to files like AGENTS.md (or equivalent for other clients, e.g. Cursor Rules or CLAUDE.md) to let the LLM know about the MCP and its tools.

But for example in Cursor (and in a few other clients too I believe), all the context is already available:

Because you already include the description of tools/resourses in the MCP's schemas:

I guess it'd be more appropriate to advice pasting that description only for the clients that do not automatically retrieve descriptions of tools? Because LLM's performance decreases as the context is filled.

[ViaAnthroposBenevolentia]

Though I notice that there still needs to be an instruction like "Whenever working in Svelte/SvelteKit code, always use Svelte MCP" cause otherwise it doesn't use it (though depends on the model I guess)

They surely do have the tools' description at their disposal (If we'll believe our kind Claude ^^):

[ViaAnthroposBenevolentia]

I notice that this repo has CLAUDE.md file, and as such you are using CC right? What was your experience with it? Do you have to specify explicitly about the tools and their definitions?

[paoloricciuti]

There are some agents that, despite having the tool descriptions, just don't use it...maybe we should tweak the docs to only advise adding the prompt in case you notice it's not really using the MCP correctly.

[ViaAnthroposBenevolentia]

Actually yes, they just don't want to use it....

Though if I only make this particular rule about svelte MCP active (while disabling other 4), it does use it. Hence this is just Client and depends:

I guess this is just poor Claude having shit load of other system prompt & tool descriptions in the context XD

Have you tested this with CC (Claude Code), @paoloricciuti ?

[paoloricciuti]

From what I've seen, almost every agent I've tried uses the MCP even without the system prompt...but I think @khromov had a different experience.

[ViaAnthroposBenevolentia]

So I guess we could change the wording in the docs for adding the AGENTS.md prompt optional? Or perhaps something like:

'If you notice that your agent is not using the MCP, try adding the following...

[ViaAnthroposBenevolentia]

There are some agents that, despite having the tool descriptions, just don't use it...maybe we should tweak the docs to only advise adding the prompt in case you notice it's not really using the MCP correctly.

Would you accept a PR in such a case, @paoloricciuti ?

[khromov]

It's fine to change the docs to say the system prompt is optional. In my experience Claude Code doesn't call tools reliably without it.

[ViaAnthroposBenevolentia]

Oh wow, I hoped that CC would be different. In such a case if 2 of the most popular clients require it, I even doubpt that it should be optional 😅