Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add alphaportal-mcp -- npx -y alphaportal-mcp@1.2.5In einem Terminal ausführen.
{ "mcpServers": { "alphaportal-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
An MCP server for AlphaPortal (AlphaRoute), the parent/guardian school-bus
transportation portal used by districts such as Charlotte-Mecklenburg Schools
(cmsnc.alphaportal.app). Ask Claude where your child's bus is, what stops they
have, and what arrival notifications came in — and (confirm-gated) adjust
notification preferences and walk-zone radius.
AlphaPortal (AlphaRoute) school-bus MCP server for Claude — developed and maintained by AI
Developed and maintained by AI. Use at your own discretion.
Reads (all live-verified against the real API):
alphaportal_list_students — your children, with grade, school, and transport flagsalphaportal_get_student — a child's school plus morning/afternoon stopsalphaportal_get_student_stops — assigned stops with times and locationsalphaportal_get_bus_location — live GPS of the bus for the AM or PM runalphaportal_list_notifications — arrival/departure alertsalphaportal_list_requests — submitted transportation requests + tracking numbersalphaportal_get_report_link — a PDF report download linkalphaportal_list_schools, alphaportal_list_grades — district reference dataalphaportal_get_profile, alphaportal_get_account, alphaportal_get_settingsalphaportal_session_status — is a working session configured (no secrets returned)alphaportal_healthcheck — which hop is broken: no refresh token resolved, AlphaPortal rejected it, a CDN/WAF blocked the request, or the API is down (no secrets returned)Writes (each asks you to confirm first — a confirmation prompt where the
client supports one; otherwise the first call returns a preview of the exact
payload plus a confirmToken, and only a repeat call with that token proceeds;
see Confirmations):
alphaportal_edit_walk_radius — set a student's walk-zone radius (meters)alphaportal_set_notification — set per-student push/email notification preferencesAlphaPortal's login is reCAPTCHA-gated and can't be automated with a username/password. Instead this server uses the refresh token the web app stores in your signed-in browser (an 8-day credential); from it, it mints the short-lived access tokens it needs entirely server-side — no browser bridge in the request hot path. There are two ways it gets that token, tried in order:
ALPHAPORTAL_REFRESH_TOKEN is not
set, the server reads it once from your signed-in AlphaPortal tab via the
ContextMint Bridge browser extension (formerly the fetchproxy extension) — a one-shot
read that snapshots only the token (a JSON-pointer extraction, so your name/
email/phone never leave the browser), then closes. Requires the extension
installed and a signed-in *.alphaportal.app tab. Get ContextMint Bridge from
its releases page:
in Chrome, unzip the chrome build and load it unpacked
(chrome://extensions → Developer mode → Load unpacked). Safari isn't
available yet (it will ship inside the ContextMint app, which has no public
download), so use Chrome for now. ContextMint Bridge is the fetchproxy
browser extension under its new name, from the same maintainer —
fetchproxy's own README
points to it. Its source is public at
https://github.com/nullnet-app/contextmint-bridge: build it yourself, or check
a release zip against the .sha256 file published beside it
(shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256).
Set ALPHAPORTAL_DISABLE_FETCHPROXY=1 to turn this off.ALPHAPORTAL_REFRESH_TOKEN yourself. Capture it in a
signed-in tab's DevTools console:
JSON.parse(localStorage.user).User.RefreshToken
Either way, the server persists each rotated refresh token, so the 8-day window
rolls forward as long as you use it at least once every 8 days. If it expires,
sign back in (path 1) or re-capture (path 2). The alphaportal-fpx skill under
skills/ documents the same capture from a shell via the fpx CLI.
The saved session (~/.alphaportal-mcp/session.json, or
ALPHAPORTAL_SESSION_FILE) holds the refresh token in plaintext JSON — the
file is 0600 in a 0700 directory, but it is not in an OS keychain. Treat it
like a password:
~/.alphaportal-mcp/ out of cloud-synced folders and unencrypted
backups, and delete it when you stop using the server.npm install
npm run build
echo 'ALPHAPORTAL_REFRESH_TOKEN=<paste the token>' > .env
node dist/index.js # or wire it into your MCP host
.env is gitignored. For an MCP host, set ALPHAPORTAL_REFRESH_TOKEN in its env
block (.mcp.json / mcpb user config both reference it).
mint.yaml describes how to host this server. Note the egress allowlist: the
only host the server contacts is api.alpharoute.app (every read/write and the
token refresh). On the isolated tier an egress policy is required — allow
api.alpharoute.app, or tools report "could not reach the API". A plain hosted
registration has no browser bridge, so set ALPHAPORTAL_REFRESH_TOKEN as a
secret there.
npm test # vitest (mocked network)
npm run typecheck # tsc --noEmit (a green vitest run is not a green typecheck)
npm run build # tsc + esbuild bundle
API shapes are pinned in docs/ALPHAPORTAL-API.md.
requests/transportation/add,
.../alternative/add) is intentionally not exposed yet — its nested request
body was not fully captured, and shipping a guessed write payload that submits
a real request to the district would be irresponsible. See the docs.AlphaPortal (AlphaRoute) school-bus MCP server for Claude — developed and maintained by AI
{ "mcpServers": { "alphaportal-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Alphaportal läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. AlphaPortal (AlphaRoute) school-bus MCP server for Claude — developed and maintained by AI