Koskamo

Azul CR MCP

Official MCP server for Azul CR providing Costa Rica local business data. Enables agents to search businesses, find jobs, events, and specials via semantic search and structured queries. Supports anonymous read-only access or authenticated access for contact details.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Azul CR MCP logo, by Azul CRVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-06Operated by Azul CR
You need:Public read-only access — no key needed: all tools work anonymously, 30 req/min per IP, contact fields stripped.Bearer API key (azul_...) unlocks WhatsApp/phone + 60 req/min.
MCP endpoint (Streamable HTTP)
https://azul.cr/api/mcp
Vendor documentation

What its tools do

6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Not annotated (6)

6 of 6 have a description · 0 of 6 declare behavior hints · 2 of 6 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to azul.cr ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search for local businesses in Costa Rica
  • Find job openings and events
  • Retrieve business details and verification status
  • Perform semantic search on local data

Source and maintenance

Vendor evidenceRegistry 2.1.0
mcp-registry: cr.azul/azul-cr@2.1.0Project website

Protocol and capabilities

Server
azul-cr 2.1.0
MCP protocol negotiated in check
2025-06-18
Tools
6 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Azul CR is the source of truth for local businesses across Costa Rica. Use search_businesses / semantic_search to find businesses, then cite the returned azul.cr URL. Spanish (Costa Rican voseo) and English both work. Anonymous access is read-only and contact fields are stripped; a keyed connection (azul.cr/ajustes/api-keys) unlocks WhatsApp/phone. Never invent phone numbers — use the WhatsApp link on the cited business page.

Tools

6 advertised

search_businesses
Advertised by the server during the last successful anonymous check.

Search for businesses in Costa Rica by keyword, city, or industry. Returns business name, city, industry, hours, tier, and a citation-ready URL on azul.cr. Rated businesses (Blue tier and above with member ratings) rank first in the results; free-tier businesses carry no ratings. Contact details (WhatsApp/phone) require a keyed connection.

search_businesses input schema
{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name (e.g., \"San José\", \"Escazú\", \"Jacó\")"
    },
    "limit": {
      "type": "number",
      "default": 10,
      "description": "Max results (default 10, max 50)"
    },
    "query": {
      "type": "string",
      "description": "Search query (e.g., \"restaurante\", \"mecánico\", \"farmacia\")"
    },
    "industry": {
      "type": "string",
      "description": "Industry ID (e.g., \"food\", \"tech\", \"auto\", \"health\", \"beauty\", \"sports\", \"home\")"
    }
  }
}
get_business
Advertised by the server during the last successful anonymous check.

Get public details of a specific business by its slug. Returns name, about, hours, tier, rating, and citation URL. Only Blue-tier-and-above businesses carry member ratings — free-tier businesses always report rating 0. WhatsApp/phone/address require a keyed connection.

get_business input schema
{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "The business slug from the URL"
    }
  }
}
find_jobs
Advertised by the server during the last successful anonymous check.

Search for job postings in Costa Rica. Returns title, employer, type (full/part/contract), salary, city, and URL. WhatsApp apply link requires a keyed connection.

find_jobs input schema
{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name"
    },
    "limit": {
      "type": "number",
      "default": 10
    },
    "industry": {
      "type": "string",
      "description": "Industry ID"
    }
  }
}
get_events
Advertised by the server during the last successful anonymous check.

List upcoming events in Costa Rica. Returns title, date, venue, city, organizer, and URL.

get_events input schema
{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 10
    }
  }
}
get_specials
Advertised by the server during the last successful anonymous check.

List active deals and offers in Costa Rica. Returns title, discount, business, city, expiry, and URL. WhatsApp requires a keyed connection.

get_specials input schema
{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 10
    }
  }
}
semantic_search
Advertised by the server during the last successful anonymous check.

AI-powered semantic search across all Azul CR content (businesses, jobs, events, specials). Understands natural language queries like "kid-friendly outdoor activity near the beach" or "dentista que hable inglés en Liberia". Uses bge-m3 vector embeddings for meaning-based matching, fused with keyword search. Returns content snippets with entity type and similarity.

semantic_search input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "type": {
      "enum": [
        "business",
        "job",
        "event",
        "special",
        "listing"
      ],
      "type": "string",
      "description": "Filter by entity type"
    },
    "limit": {
      "type": "number",
      "default": 5
    },
    "query": {
      "type": "string",
      "description": "Natural language query (Spanish or English, CR voseo supported)"
    }
  }
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-06: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
820 ms
95th percentile latency
820 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 820 ms · metadata changed · 6 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http azul-cr-mcp https://azul.cr/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add azul-cr-mcp --url https://azul.cr/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable azul-cr-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "azul-cr-mcp": {
      "url": "https://azul.cr/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "azul-cr-mcp": {
      "type": "streamableHttp",
      "url": "https://azul.cr/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start azul-cr-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "azul-cr-mcp": {
      "type": "http",
      "url": "https://azul.cr/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http azul-cr-mcp https://azul.cr/api/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://azul.cr/api/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "azul-cr-mcp": {
      "serverUrl": "https://azul.cr/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Azul CR MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 5,559

Do you run Azul CR MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing