Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions contracts/mcp-live-surface.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"contractVersion": 2,
"registeredToolCount": 25,
"registeredToolCount": 30,
"registeredTools": {
"publicRead": [
"list_utm_buildings",
Expand All @@ -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",
Expand Down
23 changes: 14 additions & 9 deletions src/content/docs/ai/tools.md
Original file line number Diff line number Diff line change
@@ -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.

Expand All @@ -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

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/)

Expand Down
Loading