MCPCache
Defined in: packages/mcp-query/src/core/cache.ts:61
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new MCPCache(
opts?):MCPCache
Defined in: packages/mcp-query/src/core/cache.ts:69
Parameters
Section titled “Parameters”events?
Section titled “events?”CacheEvents
() => number
Returns
Section titled “Returns”MCPCache
Methods
Section titled “Methods”abortInflight()
Section titled “abortInflight()”abortInflight(
key):void
Defined in: packages/mcp-query/src/core/cache.ts:152
Abort an in-flight fetch (called when the last observer leaves).
Parameters
Section titled “Parameters”Returns
Section titled “Returns”void
dehydrate()
Section titled “dehydrate()”dehydrate():
object
Defined in: packages/mcp-query/src/core/cache.ts:238
A serializable snapshot of successful entries (data + tags + age).
Returns
Section titled “Returns”object
entries
Section titled “entries”entries:
object[]
entriesForDevtools()
Section titled “entriesForDevtools()”entriesForDevtools():
CacheEntry<unknown>[]
Defined in: packages/mcp-query/src/core/cache.ts:226
Returns
Section titled “Returns”CacheEntry<unknown>[]
getSnapshot()
Section titled “getSnapshot()”getSnapshot(
key):CacheEntry<unknown> |undefined
Defined in: packages/mcp-query/src/core/cache.ts:75
Parameters
Section titled “Parameters”Returns
Section titled “Returns”CacheEntry<unknown> | undefined
getVersion()
Section titled “getVersion()”getVersion(
key):number
Defined in: packages/mcp-query/src/core/cache.ts:80
The value useSyncExternalStore observes — changes on every emit for this key.
Parameters
Section titled “Parameters”Returns
Section titled “Returns”number
hydrate()
Section titled “hydrate()”hydrate(
snapshot):void
Defined in: packages/mcp-query/src/core/cache.ts:246
Restore a snapshot. Entries keep their original age, so staleTime still applies.
Parameters
Section titled “Parameters”snapshot
Section titled “snapshot”entries
Section titled “entries”object[]
Returns
Section titled “Returns”void
inflight()
Section titled “inflight()”inflight(
key):Promise<unknown> |undefined
Defined in: packages/mcp-query/src/core/cache.ts:143
The promise of an in-flight fetch for this key, if any (for request de-duping).
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<unknown> | undefined
invalidateTags()
Section titled “invalidateTags()”invalidateTags(
tags,broadcast?):void
Defined in: packages/mcp-query/src/core/cache.ts:166
RTK Query-style: mark every entry carrying any of these tags stale.
Parameters
Section titled “Parameters”string[]
broadcast?
Section titled “broadcast?”boolean = true
Returns
Section titled “Returns”void
isStale()
Section titled “isStale()”isStale(
key):boolean
Defined in: packages/mcp-query/src/core/cache.ts:85
True if the entry is missing, errored, or older than its staleTime.
Parameters
Section titled “Parameters”Returns
Section titled “Returns”boolean
markStaleByServer()
Section titled “markStaleByServer()”markStaleByServer(
server):void
Defined in: packages/mcp-query/src/core/cache.ts:195
Blunt invalidation used on reconnect when the capability set may have changed.
Parameters
Section titled “Parameters”server
Section titled “server”string
Returns
Section titled “Returns”void
onListChanged()
Section titled “onListChanged()”onListChanged(
server,what):void
Defined in: packages/mcp-query/src/core/cache.ts:190
Protocol-driven: notifications/
Parameters
Section titled “Parameters”server
Section titled “server”string
"tools" | "resources" | "prompts"
Returns
Section titled “Returns”void
onResourceUpdated()
Section titled “onResourceUpdated()”onResourceUpdated(
server,uri):void
Defined in: packages/mcp-query/src/core/cache.ts:185
Protocol-driven: notifications/resources/updated -> invalidate that exact resource.
Parameters
Section titled “Parameters”server
Section titled “server”string
string
Returns
Section titled “Returns”void
patch()
Section titled “patch()”patch(
patches): () =>void
Defined in: packages/mcp-query/src/core/cache.ts:201
Apply patches, return a rollback fn. Used by useTool before a mutation resolves.
Parameters
Section titled “Parameters”patches
Section titled “patches”Returns
Section titled “Returns”() => void
setError()
Section titled “setError()”setError(
key,error):void
Defined in: packages/mcp-query/src/core/cache.ts:157
Parameters
Section titled “Parameters”Returns
Section titled “Returns”void
setFetching()
Section titled “setFetching()”setFetching(
key):void
Defined in: packages/mcp-query/src/core/cache.ts:117
Parameters
Section titled “Parameters”Returns
Section titled “Returns”void
setInflight()
Section titled “setInflight()”setInflight(
key,promise,abort?):void
Defined in: packages/mcp-query/src/core/cache.ts:146
Parameters
Section titled “Parameters”promise
Section titled “promise”Promise<unknown> | undefined
abort?
Section titled “abort?”AbortController
Returns
Section titled “Returns”void
setProtocolSubscribed()
Section titled “setProtocolSubscribed()”setProtocolSubscribed(
key,value):void
Defined in: packages/mcp-query/src/core/cache.ts:221
Mark whether the connection layer has an active resources/subscribe for this key.
Parameters
Section titled “Parameters”boolean
Returns
Section titled “Returns”void
subscribe()
Section titled “subscribe()”subscribe(
key,fn): () =>void
Defined in: packages/mcp-query/src/core/cache.ts:93
Returns an unsubscribe fn. Ref-counts subscribers and drives gc + protocol subscribe.
Parameters
Section titled “Parameters”Listener
Returns
Section titled “Returns”() => void
subscribeAll()
Section titled “subscribeAll()”subscribeAll(
fn): () =>void
Defined in: packages/mcp-query/src/core/cache.ts:231
Fires on any change to any entry — used by the persister.
Parameters
Section titled “Parameters”() => void
Returns
Section titled “Returns”() => void
write()
Section titled “write()”write<
T>(key,data,opts?):void
Defined in: packages/mcp-query/src/core/cache.ts:124
Type Parameters
Section titled “Type Parameters”T
Parameters
Section titled “Parameters”T
CacheWriteOpts = {}
Returns
Section titled “Returns”void