Skip to content
MCP server

Alphaportal MCP

AlphaPortal school-bus transportation for Claude — students, stops, live bus location…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.3.0
Listing updated
4 days ago

About Alphaportal MCP

Alphaportal MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

AlphaPortal school-bus transportation for Claude — students, stops, live bus location, notifications

Install

Run in a terminal

claude mcp add alphaportal-mcp --env ALPHAPORTAL_REFRESH_TOKEN='<ALPHAPORTAL_REFRESH_TOKEN>' -- npx -y alphaportal-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "alphaportal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alphaportal-mcp"
      ],
      "env": {
        "ALPHAPORTAL_REFRESH_TOKEN": "<ALPHAPORTAL_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "alphaportal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alphaportal-mcp"
      ],
      "env": {
        "ALPHAPORTAL_REFRESH_TOKEN": "<ALPHAPORTAL_REFRESH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "alphaportal-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "alphaportal-mcp"
      ],
      "env": {
        "ALPHAPORTAL_REFRESH_TOKEN": "<ALPHAPORTAL_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "alphaportal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alphaportal-mcp"
      ],
      "env": {
        "ALPHAPORTAL_REFRESH_TOKEN": "<ALPHAPORTAL_REFRESH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "alphaportal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "alphaportal-mcp"
      ],
      "env": {
        "ALPHAPORTAL_REFRESH_TOKEN": "<ALPHAPORTAL_REFRESH_TOKEN>"
      }
    }
  }
}

Configuration

  • ALPHAPORTAL_REFRESH_TOKENOptional refresh token; if unset, read from a signed-in tab via the ContextMint Bridge extension
  • ALPHAPORTAL_DISABLE_FETCHPROXYSet to `1` to disable the browser-bridge fallback and require ALPHAPORTAL_REFRESH_TOKEN.
  • ALPHAPORTAL_SESSION_FILEOverride the session store path (default `~/.alphaportal-mcp/session.json`).
  • FETCHPROXY_WS_PORTLocalhost concentrator port (default 37149). On one machine every MCP shares the concentrator, so move it for ALL of them or not at all.
  • FETCHPROXY_WS_HOSTBind interface (default 127.0.0.1; a literal IP only, anything else is ignored). Keep on loopback — it exists for ONE topology: a hosted child in its own network namespace.
  • FETCHPROXY_IDENTITY_DIRWhere to store the long-term fetchproxy identity keypair (default ~/.fetchproxy/identity/; an absolute path only, anything else is ignored). Exists for a host that runs a separate child per caller, so they can share one identity.

Pricing

Open source

Alphaportal MCP FAQ

Is Alphaportal MCP free?

Yes. Alphaportal MCP is open source, so you can use and self-host it for free.

How do I add Alphaportal MCP to Claude Code?

Run this command in your terminal: claude mcp add alphaportal-mcp --env ALPHAPORTAL_REFRESH_TOKEN='<ALPHAPORTAL_REFRESH_TOKEN>' -- npx -y alphaportal-mcp