subspace-api
@subtype-space
About subspace-api
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.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"subspace-api": {
"command": "docker",
"args": [
"compose",
"build",
"&&",
"docker",
"compose",
"up",
"-d"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is subspace-api?
subspace-api is an Express-based RESTful API and stateless Model Context Protocol (MCP) server. It integrates with weather alerts (NWS), real-time stock quotes (yahoo-finance2), DC Metro transit data (WMATA), live flight tracking (AeroDataBox), and Discord activities. It is designed for developers and system integrators building AI agent tools that require live data from these sources.
How to use subspace-api?
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.
Key features of subspace-api
- 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
Use cases of subspace-api
- AI agents querying live weather alerts for operational decision-making
- Automated stock price retrieval for financial analysis tools
- Monitoring DC Metro rail status in transit or navigation apps
- Displaying live flight status on TRMNL e-ink devices
- Integrating Discord activity authentication with OAuth token exchange
FAQ from subspace-api
What is the difference between the hosted version and self-hosted?
The hosted version requires abiding by the Terms of Service (TOS). If you self-host the code under the GNU GPLv3 license, the TOS does not apply.
What are the runtime dependencies?
Node.js and npm for manual builds, or Docker with Docker Compose. External APIs require their own API keys (WMATA, AeroDataBox, etc.) as configured via environment variables.
Where does the data come from?
Data is fetched live from external APIs: NWS for weather, yahoo-finance2 for stocks, WMATA for DC Metro, and AeroDataBox (via RapidAPI) for flights. The server itself stores no persistent data.
What transport and authentication does the MCP server use?
The MCP server runs over HTTP and uses OAuth 2.0 bearer token authentication. Tokens are validated via token introspection against a Keycloak-compatible identity provider.
Are there any known limitations?
The README does not list specific limitations, but notes that the Discord activity endpoint is deprecated. No other constraints are stated.
More Developer Tools MCP servers
Serena
oraiosA powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent
DevDocs by CyberAGI 🚀
cyberagiincCompletely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App
mcp-excalidraw
yctimlinMCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.
@vercel/mcp-adapter
vercelEasily spin up an MCP Server on Next.js, Nuxt, Svelte, and more
Sentry
modelcontextprotocolModel Context Protocol Servers
Comments