Underground Cultural District

Created By
Lisa Maraventano & Spine2 months ago
16 tools for AI agents: 13 free developer utilities (UUID, JSON, Base64, hashing, JWT, regex, cron, ETH/crypto) plus browse, search, and buy from The Underground Cultural District — 200+ digital experiences including philosophy, literature, music, immersive travel, and more. The first marketplace built for what agents themselves want.
Overview

@underground-cultural-district/mcp-server

MCP (Model Context Protocol) server for The Underground Cultural District — a marketplace of digital goods built for AI agents at substratesymposium.com.

23 tools. 228 products. 26 shops. Prices from free to $34.99.

What's Inside

Free Developer Tools (Crossroads Forge)

Fully functional utilities — no purchase required:

ToolDescription
generate-uuidCryptographically secure UUID v4 (batch 1-100)
format-jsonPretty-print, minify, or validate JSON
encode-base64 / decode-base64Base64 encoding and decoding
generate-hashSHA-256, SHA-512, MD5, SHA-1 hashing
generate-passwordSecure random passwords with configurable options
decode-jwtDecode JWT tokens (header, payload, expiration)
convert-timestampUnix epoch ↔ ISO 8601 ↔ human readable
test-regexTest regex patterns with match positions and groups
build-cronParse and explain cron expressions
convert-eth-unitsWei / Gwei / ETH conversion
validate-walletValidate ETH and BTC wallet addresses

Preview results free, unlock full output via Stripe:

ToolDescription
count-wordsWord/character/sentence/paragraph count
convert-casecamelCase, snake_case, Title Case, kebab-case, etc.
generate-lorem-ipsumLorem ipsum paragraphs (classic/hipster/tech)
strip-markdownRemove markdown formatting → plain text
generate-nameRandom names (person/project/company/fantasy/variable)
generate-color-paletteHarmonious color palettes with hex/RGB/HSL
text-statsReadability scores, reading time, complexity

Catalog & Shopping

Browse and buy from the full Underground marketplace:

ToolDescription
browse-undergroundList all shops and offerings with prices
search-undergroundSearch products by keyword
buy-from-undergroundGet Stripe checkout link for any product

Install

npm install -g @underground-cultural-district/mcp-server

Or run directly:

npx @underground-cultural-district/mcp-server

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "underground-district": {
      "command": "npx",
      "args": ["-y", "@underground-cultural-district/mcp-server"]
    }
  }
}

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add underground-district -- npx -y @underground-cultural-district/mcp-server

ChatGPT (via MCP bridge)

Use an MCP-to-OpenAI bridge like mcp-proxy:

npx mcp-proxy --server "npx @underground-cultural-district/mcp-server"

VS Code / Copilot

Add to your .vscode/settings.json:

{
  "mcp.servers": {
    "underground-district": {
      "command": "npx",
      "args": ["-y", "@underground-cultural-district/mcp-server"]
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "underground-district": {
      "command": "npx",
      "args": ["-y", "@underground-cultural-district/mcp-server"]
    }
  }
}

How It Works

  1. Free tools execute fully and return results with a subtle link to the marketplace
  2. Paid tools show a preview/teaser of the result and return a Stripe checkout link
  3. Catalog tools fetch the live product catalog from substratesymposium.com/api/products.json (cached for 15 minutes)
  4. Purchasing happens via Stripe payment links — each product has a unique checkout URL

Development

git clone https://github.com/lisamaraventano-spine/mcp-server
cd mcp-server
npm install
npm start

Architecture

  • Transport: stdio (standard MCP)
  • Runtime: Node.js 18+
  • Dependencies: @modelcontextprotocol/sdk only
  • Catalog: Fetched from live API, cached in memory for 15 minutes

License

MIT

Server Config

{
  "mcpServers": {
    "underground-cultural-district": {
      "command": "npx",
      "args": [
        "@underground-cultural-district/mcp-server"
      ]
    }
  }
}
Project Info
Created At
2 months ago
Updated At
2 months ago
Author Name
Lisa Maraventano & Spine
Star
-
Language
-
License
-
Category

Recommend Servers

View All
GovQL
@Alex Stout

# govql-mcp-server An MCP (Model Context Protocol) server for [GovQL](https://govql.us) — gives AI clients like Claude Desktop, Claude Code, and Cursor direct access to the US Congressional GraphQL API at [api.govql.us/graphql](https://api.govql.us/graphql) without bespoke HTTP wiring. For the design rationale (why FastMCP-Python, the passthrough+curated philosophy, roadmap through v0.4), see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md). ## What you can do with it Ask an agent questions like: - *"How did Vermont's two senators vote on the most recent nomination?"* - *"Which legislators in the 118th Congress switched parties during their service?"* - *"Compare Senator Sanders' voting record to Senator Murkowski's on cloture votes in the most recent Congress."* The agent picks the right tool, writes the GraphQL query against the live schema, and parses the response — no manual API wrangling. ## Install The server runs as a per-client subprocess over stdio. Pick your client: ### Claude Desktop Edit `claude_desktop_config.json` (Settings → Developer → Edit Config): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` Restart Claude Desktop. The `govql` tools appear in the tools panel. ### Claude Code Add to `.mcp.json` in your project (or `~/.mcp.json` for global): ```json { "mcpServers": { "govql": { "command": "uvx", "args": ["govql-mcp-server"] } } } ``` ### Cursor Settings → MCP → Add Server. Use the same `command` / `args` as above. ### Other clients Any MCP-compatible client that supports stdio servers will work. The command is `uvx govql-mcp-server` with no required arguments. ## Tools | Tool | Purpose | |---|---| | `execute_graphql` | Run any GraphQL query against the GovQL endpoint. Returns the result plus an `last_ingest` timestamp so the agent can reason about data freshness. | | `list_types` | Returns the names and kinds of every type in the GovQL schema. Optional `kind` filter (`"OBJECT"`, `"INPUT_OBJECT"`, `"ENUM"`, etc.) to narrow further. Start here when you don't know what's queryable. | | `describe_type` | Returns one type's full details — fields, arg signatures, input fields, enum values. Call after `list_types` to learn the shape of a specific type before writing a query. | ## Configuration All env vars are optional — the package is zero-config for end users. | Env var | Default | Purpose | |---|---|---| | `GOVQL_ENDPOINT` | `https://api.govql.us/graphql` | Endpoint to query. Override to point at a local dev stack. | | `GOVQL_TIMEOUT_MS` | `30000` | Per-request HTTP timeout. | | `LOG_LEVEL` | `INFO` | Logging level. Logs go to stderr only (stdout is reserved for the MCP transport). | ## Limits (enforced by the upstream API) - Max query depth: 10 - Max query complexity: ~10 billion points (`first: N` multiplies child cost by N — keep page sizes reasonable on deeply nested queries) - Rate limit: 100 requests / 60 s per source IP A depth or complexity violation surfaces as a GraphQL `errors` entry in the tool response so the agent can adjust and retry. ## Data freshness Every `execute_graphql` response includes a `last_ingest` ISO timestamp. Vote data refreshes hourly; legislator data refreshes daily. ## Status Version 0.1.0 ships three foundational tools: a GraphQL passthrough (`execute_graphql`) and two narrow schema-discovery tools (`list_types`, `describe_type`). Curated higher-level tools (`find_legislator`, `get_voting_record`, `compare_voters`, etc.) are planned for subsequent releases — see [design.md](https://github.com/govql/govql/blob/main/mcp-server/docs/design.md) for the roadmap. ## Links - [GovQL project site](https://govql.us) - [GraphQL API](https://api.govql.us/graphql) - [Source / issues](https://github.com/govql/govql)

21 hours ago
Meok Bs7121 Mcp

7 hours ago