subspace-api
About
An express-based RESTful API and Model Context Protocol (MCP) server for services used by subtype.space and for TRMNL users, featuring OAuth support and integration with Keycloak.
Details
- Author
- subtype-space
- Downloads
- 386
- Categories
- Developer Tools
Jump to
- Stateless MCP server secured with OAuth 2.0 bearer tokens
- Real-time stock quotes via yahoo-finance2
- NWS weather alerts and forecasts as MCP tools
- DC Metro rail incidents and arrival predictions
- Live flight status via AeroDataBox with TRMNL plugin support
- Discord OAuth token exchange endpoint for activities
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
subspace-apiCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Docker Compose (docker compose build && docker compose up -d) or by manually running npm run build && npm run start. Configure required environment variables (OAuth client credentials, auth server URL, MCP server URL) and optional ones for TRMNL plugins and Discord activity. The server then exposes MCP tools over HTTP secured with OAuth 2.0 bearer tokens.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"subspace-api": {
"subspace-api": {
"command": "docker",
"args": [
"compose",
"build",
"&&",
"docker",
"compose",
"up",
"-d"
]
}
}
}
}McpServers
{
"subspace-api": {
"command": "docker",
"args": [
"compose",
"build",
"&&",
"docker",
"compose",
"up",
"-d"
]
}
}subspace-api
subspace-api is an Express-based RESTful API and stateless Model Context Protocol (MCP) server.If you are utilizing this API as provided and hosted by us, please be sure to abide by the TOS. Otherwise, you are free to clone and self-host provided you abide by the GNU GPLv3 license, and the TOS will not pertain to you.
Features
- MCP Server — Stateless Model Context Protocol server over HTTP, secured with OAuth 2.0 bearer tokens
- Weather tools — NWS alerts and forecasts via MCP
- Stock quotes — Real-time stock data via MCP (powered by yahoo-finance2)
- DC Metro (WMATA) — Rail incident reports and live arrival predictions; also exposed as MCP tools
- Flight Tracker — Live flight status via AeroDataBox (RapidAPI); TRMNL plugin for e-ink display
- Discord Activity — OAuth token exchange endpoint for Discord activities
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
