# MCP: Tool List Caching

**URL:** <https://forum.cursor.com/t/mcp-tool-list-caching/174607>\
**Category:** Help\
**Tags:** mcp\
**Created:** [October 13, 2026, 3:18pm UTC](https://forum.cursor.com/t/mcp-tool-list-caching/174607 "2026-10-13T15:18:12Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![krystian](https://avatars.discourse-cdn.com/v4/letter/k/9d8465/32.png) [@krystian](https://forum.cursor.com/u/krystian)\
**Post date:** [October 13, 2026, 3:18pm UTC](https://forum.cursor.com/t/mcp-tool-list-caching/174607/1 "2026-10-13T15:18:12Z")

</div>

hey folks! im iterating on an mcp server, and having my cursor agent it test itself.

the problem im running into is cursor’s tool list cache remains stale as my tool list changes (new tools added, old tools updated).

the typical workaround i see people doing is creating a dedicated tool called `list_tools()` and then `call_tool()` which comes with the downside of side skirting any sort of built-into-harness safety/tool use confirmation measures.

asking the agent to just re-authenticate that mcp server doesn’t refresh the cache either.

Any ideas?

---

<div class="post-metadata">

**Author:** ![deanrie](https://sea3.discourse-cdn.com/cursor1/user_avatar/forum.cursor.com/deanrie/32/1263_2.png) [@deanrie](https://forum.cursor.com/u/deanrie)\
**Post date:** [October 15, 2026, 12:01pm UTC](https://forum.cursor.com/t/mcp-tool-list-caching/174607/5 "2026-10-15T12:01:29Z")

</div>

Hey, thanks for the report. This is a known issue that we’re tracking, and I’ve added your case to it.

After Cursor loads a server’s tool list once, a reconnect like Reload, toggling it off and on, or signing in again reuses the cached list instead of making a new request to the server. That’s why re-authenticating doesn’t help. It’s just a reconnect. Fully quitting Cursor, with all windows closed, clears the cache.

There are 2 ways to get a fresh tool list without restarting:

1. Slightly change the server entry in `mcp.json` each time the tools change. Cursor treats the changed entry as a new server and reloads the tools from scratch. For a command-based stdio server, it’s enough to bump a dummy env variable:

```json
"env": { "MCP_REV": "2" }

```

For a URL-based server, add or bump a dummy header, for example `"headers": { "X-Mcp-Rev": "2" }`. If the server uses sign-in, you may need to sign in again after the change. The agent can make this edit itself as part of the test cycle.

1. Have the server send `notifications/tools/list_changed` while Cursor is connected, for example right after the tool set changes. Cursor should reload the tool list when it gets that notification.

About `list_tools()` and `call_tool()`, you’re right. That approach bypasses the harness checks for tool confirmation, so I wouldn’t recommend it.

If neither option picks up the new tools, send over your Cursor version from Cursor \> About and the server type, stdio or URL, and I’ll dig deeper.
