# San Juan Puerto Rico Directory

> San Juan Puerto Rico Directory is a free MCP server for maps and travel. Search Puerto Rico places and events with canonical links and labelled sponsorship. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://sanjuanpuertorico.org/agents
- **MCP Registry name:** io.github.Santurce-Software-LLC/san-juan-puerto-rico-directory
- **Categories:** maps and travel, local services, events and entertainment
- **Listing updated:** 2026-11-15

## About

Sponsorship disclosure is built into this directory server. Paid placements are labelled Sponsored, publisher-owned services are labelled Featured by publisher, and query and location filters treat paid and organic entries equally. The site asks clients to keep the disclosure when showing a paid result.

The public endpoint at sanjuanpuertorico.org/mcp/discovery needs no token and offers five tools: discover_listings, get_listing, list_categories, list_municipalities and highlighted_services. A good first call lists categories and municipalities to learn the filters, then searches with something like a query, a city and a kind of business or event. Event times use Puerto Rico's UTC-4 offset. Results are a bounded selection, not a full inventory, and rate limits apply.

A separate authenticated endpoint at /mcp lets approved contributors search, list sources and upsert verified listings with evidence quotations. It requires a site-issued token.

## Features

- **Listing discovery:** Search businesses and events by query, city and kind.
- **Filter discovery:** List valid categories and municipalities.
- **Sponsorship labels:** Paid and publisher-owned results are marked.
- **Canonical links:** Results include canonical URLs to cite.
- **No token needed:** Public read endpoint is open.
- **Evidence-based contributions:** Authenticated endpoint requires source quotes.

## Good for

- Find coffee shops in San Juan
- List upcoming events with their dates
- Browse listings by municipality
- Cite a canonical page when recommending a place

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http san-juan-puerto-rico-directory https://sanjuanpuertorico.org/mcp/discovery
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sanjuanpuertorico.org/mcp/discovery
```

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

```json
{
  "mcpServers": {
    "san-juan-puerto-rico-directory": {
      "url": "https://sanjuanpuertorico.org/mcp/discovery"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "san-juan-puerto-rico-directory": {
      "type": "http",
      "url": "https://sanjuanpuertorico.org/mcp/discovery"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "san-juan-puerto-rico-directory": {
      "serverUrl": "https://sanjuanpuertorico.org/mcp/discovery"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "san-juan-puerto-rico-directory": {
      "type": "http",
      "url": "https://sanjuanpuertorico.org/mcp/discovery"
    }
  }
}
```

## Tools

- `discover_listings`: Search places and events
- `get_listing`: Retrieve one entry by kind and id
- `list_categories`: List accepted categories
- `list_municipalities`: List accepted municipalities
- `highlighted_services`: Show highlighted services

## FAQ

### Do I need an API key?

Not for the public discovery endpoint.

### How are sponsored results marked?

They are labelled Sponsored; publisher services are Featured by publisher.

### Is the search exhaustive?

No, it returns a bounded selection.

### Can I add listings?

Only through the authenticated endpoint with a site token and evidence.

### Is San Juan Puerto Rico Directory free?

Yes. San Juan Puerto Rico Directory is free to use.

### How do I add San Juan Puerto Rico Directory to Claude Code?

Run this command in your terminal: claude mcp add --transport http san-juan-puerto-rico-directory https://sanjuanpuertorico.org/mcp/discovery

### What are the best alternatives to San Juan Puerto Rico Directory?

The closest alternatives to San Juan Puerto Rico Directory are Tutu eSIM, Later Stages, Shanghai Streets Travel Guide, Virkly CVR and MaineMCP.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Virkly CVR](https://ai-powered.com/mcp/virkly-cvr): Virkly CVR is a free MCP server for local services.
- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/san-juan-puerto-rico-directory
