diff --git a/contracts/mcp-live-surface.json b/contracts/mcp-live-surface.json index e9aa9df..66d2a95 100644 --- a/contracts/mcp-live-surface.json +++ b/contracts/mcp-live-surface.json @@ -1,6 +1,6 @@ { "contractVersion": 2, - "registeredToolCount": 25, + "registeredToolCount": 30, "registeredTools": { "publicRead": [ "list_utm_buildings", @@ -11,10 +11,15 @@ "route_between_utm_buildings", "plan_utm_gap_window", "list_supported_universities", + "list_supported_campuses", "list_campus_buildings", "search_campus_buildings", "get_campus_building", - "route_between_campus_buildings" + "list_campus_places", + "search_campus_places", + "get_campus_place", + "route_between_campus_buildings", + "plan_campus_gap" ], "privateRead": [ "get_ai_delegation_status", diff --git a/src/content/docs/ai/tools.md b/src/content/docs/ai/tools.md index d5663f2..eb8be04 100644 --- a/src/content/docs/ai/tools.md +++ b/src/content/docs/ai/tools.md @@ -1,9 +1,9 @@ --- title: Tools -description: "The 25 tools in the Gapwise AI MCP surface: twelve public campus tools and thirteen permissioned student-context tools." +description: "The 30 tools in the Gapwise AI MCP surface: seventeen public campus tools and thirteen permissioned student-context tools." --- -The Gapwise AI MCP surface contains **25 tools**: twelve stateless public campus-intelligence tools, twelve permissioned private read/status/planning tools, and one bounded private write tool. +The Gapwise AI MCP surface contains **30 tools**: seventeen stateless public campus-intelligence tools (10 canonical multi-university tools and 7 deprecated UTM compatibility aliases), twelve permissioned private read/status/planning tools, and one bounded private write tool. This catalog is checked against a synchronized copy of AI's [machine-readable live-surface manifest](https://github.com/GapwiseHQ/ai/blob/main/contracts/mcp-live-surface.json). The AI runtime remains authoritative for schemas returned by MCP discovery. @@ -15,18 +15,23 @@ Public tools do **not** require a Gapwise account and do not read a student's ti | Tool | Purpose | | --- | --- | -| `list_utm_buildings` | List canonical UTM buildings with Gapwise routing/accessibility coverage and provenance. | -| `search_utm_buildings` | Search canonical buildings by code, official name, or alias with deterministic ranking and match reasons. | -| `get_utm_building` | Resolve a canonical UTM building by code, official name, or known alias; unknown or ambiguous values fail closed. | -| `search_utm_places` | Search canonical UTM places with bounded results and explicit provenance. | -| `get_utm_place` | Retrieve a canonical place by stable identifier without inventing missing access or location facts. | -| `route_between_utm_buildings` | Run Gapwise's deterministic building-to-building routing engine and preserve routed/approximate/unavailable status, verification, time/distance, accessibility state, confidence, and warnings. | -| `plan_utm_gap_window` | Run Gapwise's deterministic gap-assessment engine for an explicit free window between two UTM buildings and explicit supplied preferences. It does not discover a user's private free time. | +| `list_utm_buildings` | [Deprecated: Use `list_campus_buildings`] List canonical UTM buildings with Gapwise routing/accessibility coverage and provenance. | +| `search_utm_buildings` | [Deprecated: Use `search_campus_buildings`] Search canonical UTM buildings by code, official name, or alias with deterministic ranking and match reasons. | +| `get_utm_building` | [Deprecated: Use `get_campus_building`] Resolve a canonical UTM building by code, official name, or known alias; unknown or ambiguous values fail closed. | +| `search_utm_places` | [Deprecated: Use `search_campus_places`] Search canonical UTM places with bounded results and explicit provenance. | +| `get_utm_place` | [Deprecated: Use `get_campus_place`] Retrieve a canonical UTM place by stable identifier without inventing missing access or location facts. | +| `route_between_utm_buildings` | [Deprecated: Use `route_between_campus_buildings`] Run Gapwise's deterministic building-to-building routing engine at UTM and preserve routed/approximate/unavailable status, verification, time/distance, accessibility state, confidence, and warnings. | +| `plan_utm_gap_window` | [Deprecated: Use `plan_campus_gap`] Run Gapwise's deterministic gap-assessment engine for an explicit free window between two UTM buildings and explicit supplied preferences. | | `list_supported_universities` | List all supported universities and campus editions across the Gapwise platform with capabilities and status. | +| `list_supported_campuses` | List campus models supported across Gapwise, including routability and status, with optional university filter. | | `list_campus_buildings` | List canonical buildings for any supported university and campus with coverage and metadata. | | `search_campus_buildings` | Search canonical buildings across any supported university and campus by code, official name, or alias. | | `get_campus_building` | Resolve a canonical building for any supported university and campus; unknown values fail closed. | +| `list_campus_places` | List source-backed campus places (study spaces, dining, libraries, recreation, amenities) for any supported university and campus. | +| `search_campus_places` | Search source-backed campus places for any supported university and campus by query or filter. | +| `get_campus_place` | Retrieve a canonical campus place by stable identifier for any supported university and campus. | | `route_between_campus_buildings` | Calculate deterministic building-to-building routes across any supported university and campus with confidence and verification status. | +| `plan_campus_gap` | Run Gapwise's deterministic gap-assessment engine for an explicit free window between two campus buildings for any supported university and campus. | ## Private read, status, and planning tools diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index 93ec7ae..cb4623d 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -107,9 +107,9 @@ Gapwise AI is a separate provider-neutral remote MCP service. The client supplie - AI service: `https://ai.gapwise.ca` - Source: `https://github.com/GapwiseHQ/ai` -The live release surface exposes **25 tools total**: +The live release surface exposes **30 tools total**: -- **12 stateless public campus reads** for multi-university campus discovery, buildings, places, routes, and gap-window context; +- **17 stateless public campus reads** for multi-university campus discovery, buildings, places, routes, and gap-window context; - **12 permissioned private reads/planning tools** over explicitly delegated student context; - **1 permissioned private write tool** for a bounded gap-preference update. diff --git a/src/content/docs/quickstart.md b/src/content/docs/quickstart.md index b7d801f..91f88ab 100644 --- a/src/content/docs/quickstart.md +++ b/src/content/docs/quickstart.md @@ -28,7 +28,7 @@ Use Gapwise AI when a compatible remote MCP client needs deterministic public ca - Thirteen private tools require explicit delegation and the relevant permissions (twelve reads and one write). - Private access is permissioned, minimized, revision-aware, and revocable. - Academic timetable meetings are read-only through the AI boundary. -- The live service currently exposes **25 tools total: 12 public + 13 private**. +- The live service currently exposes **30 tools total: 17 public + 13 private**. **[Open the AI & MCP guide →](/ai/)** · **[Connect an AI client →](/ai/connect/)** · [Review privacy & security](/ai/privacy/)