subspace-api

Name: subspace-api
Author: subtype-space

@subtype-space

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

基本情報

カテゴリ

開発者ツール

ランタイム

node

トランスポート

stdio

公開者

subtype-space

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "subspace-api": {
      "command": "docker",
      "args": [
        "compose",
        "build",
        "&&",
        "docker",
        "compose",
        "up",
        "-d"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.