Skip to main content
Glama

espaciarte-mcp

Minimal MCP server exposing Espaciarte's public space discovery to external AI clients (Claude Desktop, Cursor). A thin, read-only wrapper over the backend REST API — no database access, no LLM calls, no auth, no secrets.

Tools

Tool

Wraps

Purpose

search_spaces

GET /api/discovery/spaces

Geo-search published spaces (lat/lng/radius + optional filters)

get_space_details

GET /api/discovery/spaces/:id

Full public detail of one published space

The backend already handles privacy (published spaces only, obfuscated locations, no PII); this server returns its responses untouched.

Related MCP server: geocontext

Setup

pnpm install
pnpm build

Requires the backend running (default http://localhost:8000 — pnpm dev in espaciarte-backend/ with the DB up).

Configuration

Single env var:

Var

Default

Purpose

BACKEND_BASE_URL

http://localhost:8000

Espaciarte backend URL

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "espaciarte": {
      "command": "node",
      "args": ["/Users/vicentecantu/Development/espaciarte/espaciarte-mcp/dist/index.js"],
      "env": { "BACKEND_BASE_URL": "http://localhost:8000" }
    }
  }
}

Cursor (~/.cursor/mcp.json or .cursor/mcp.json)

{
  "mcpServers": {
    "espaciarte": {
      "command": "node",
      "args": ["/Users/vicentecantu/Development/espaciarte/espaciarte-mcp/dist/index.js"],
      "env": { "BACKEND_BASE_URL": "http://localhost:8000" }
    }
  }
}

Smoke test

pnpm smoke     # 9-check battery: both tools live, error paths, privacy fields (needs backend up)
pnpm inspect   # MCP Inspector UI against the built server

Or headless: npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

Note: local seed data is geo-centered on Monterrey (25.6866, -100.3161) — searches around other cities correctly return 0 items.

Available Tools

2 tools
get_space_detailsGet Espaciarte space detailsA
Read-only

Fetch the full public detail of one published Espaciarte space by id: description, rules, photos, activities, weekly availability, pricing, add-ons, and host profile.

Inputs: id (required).

search_spacesSearch Espaciarte spacesA
Read-only

Search published spaces (event venues, workspaces, studios…) on Espaciarte around a geographic point, with optional filters. Returns a paginated list of public space summaries: name, venue type, capacity, pricing, photos, and approximate (obfuscated) location.

Inputs: lat (required), lng (required), radius (required), date, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one searches for spaces with filtering, while the other retrieves full details for a specific space. There is no overlap or ambiguity in their intended use.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (search_spaces, get_space_details). Though the verbs differ, the structure is predictable and readable.

    Tool Count3/5

    With only 2 tools, the server feels minimal but not absurdly thin. The scope appears to be read-only space exploration, and these two tools cover the primary needs, though more operations could be expected.

    Completeness4/5

    For a public-facing space discovery API, the combination of search and detail retrieval covers the core use case. Missing operations like booking or creating are outside the apparent purpose, so no critical gaps are evident.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI agents to interact with the SpaceTraders API, managing agents, fleets, contracts, and trading operations in the SpaceTraders universe.
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      An experimental MCP server providing spatial context for LLMs by interfacing with French Geoplateforme services. It enables tasks such as geocoding, altitude lookups, and querying administrative, cadastral, or urban planning data.
      5 npm
      4
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for spatial queries via the Terranode Geospatial API, enabling AI agents to perform point-in-polygon lookups, nearest feature search, distance calculations, and spatial joins.
      6
      48 npm
      MIT