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.

#openai #typescript-api #expre #openai-api #model-context-protocol #mcp-server #model-context-protocol-servers #openai-mcp #openai-type

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.

Frequently asked questions

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.

Comments

Basic information

More Developer Tools MCP servers

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

Routebase

Routebase keeps your API's design, docs, contract tests, mocks and monitoring in one living OpenAPI spec so they can't drift apart. Agents work on that same source of truth, under your team's permissions.

TaskerArmy Agent

TaskerArmy

Ask Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.

ship.page

Bitgate

Throw HTML at an API, get an unguessable URL back. Zero-config remote MCP server — your agent deploys pages, sites and CI reports in one call. Free, no signup needed.

Codex Pets

astandrik

Public read-only MCP server for discovering, inspecting, installing, and sharing approved Codex-compatible animated pet packs.