Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.navisops.com/llms.txt

Use this file to discover all available pages before exploring further.

MCP resources are read-only data endpoints that give AI clients a structured snapshot of your workspace. The Navis Ops MCP server exposes four static resources and one templated resource. All resources require mcp:read scope (or mcp:write). Resources are fetched on demand — every time your AI client reads a resource, it gets the current data at that moment. There are no live subscriptions or push updates. If you need fresh data after making changes, your client must re-read the resource.

Reading a resource

Use the resources/read JSON-RPC method with the resource URI:
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "navis://workspace/summary"
  }
}
To list available resources, use resources/list. For templated resources, use resources/templates/list to get the URI template, then construct the URI with your values.

Static resources

These four resources are always available. Their URIs are fixed — no parameters required.

Templated resource

Templated resources use URI templates (RFC 6570). Fill in the parameter to construct a valid URI, then read it with resources/read.

Resource freshness

Resources are fetched on demand — they reflect the current state of your workspace at the time of the read. There are no live subscriptions or change notifications. If your AI assistant needs up-to-date data after making changes (for example, after calling create_task), it must re-read the relevant resource.
If you’re using an AI assistant interactively and notice it’s working from stale data, ask it to re-read the relevant resource. For example: “Re-read navis://tasks/today and tell me what’s overdue.”