@collabsmap/mcp-server
v0.1.2
Published
Model Context Protocol server for CollabsMap — discover travel brand collab opportunities for content creators.
Maintainers
Readme
@collabsmap/mcp-server
A Model Context Protocol server that exposes the CollabsMap public API to LLM agents (Claude Desktop, Cursor, Cline, Continue, custom agents).
CollabsMap indexes thousands of travel brands — hotels, resorts, tour operators, tourism boards (DMOs), airlines, and cruises — that run creator collaboration programs. With this MCP server installed, you can ask your agent things like:
- "Find hotels in Bali with gifted stay programs."
- "List the top destinations for travel creators."
- "How many creator collabs are available in Thailand?"
- "Get details for the wolo-travel listing."
The agent calls the right tool, hits the public CollabsMap API, and weaves the results into its response.
Install
Claude Desktop
Add the server to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"collabsmap": {
"command": "npx",
"args": ["-y", "@collabsmap/mcp-server"]
}
}
}Restart Claude Desktop. The four tools below will appear in the tools menu.
Cursor
Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):
{
"mcpServers": {
"collabsmap": {
"command": "npx",
"args": ["-y", "@collabsmap/mcp-server"]
}
}
}Cline (VS Code)
In Cline's settings, add an MCP server entry:
{
"collabsmap": {
"command": "npx",
"args": ["-y", "@collabsmap/mcp-server"]
}
}Continue (VS Code / JetBrains)
In ~/.continue/config.yaml:
mcpServers:
- name: collabsmap
command: npx
args: ["-y", "@collabsmap/mcp-server"]Tools
All four tools are read-only. They route through the public CollabsMap API at https://collabsmap.com/api/v1.
| Tool | Input | What it does |
|---|---|---|
| search_collabs | { country?, type?, compensation?, platform?, limit? } | Search listings/opportunities. Filter by country slug (thailand, united-states), brand type, compensation model, or platform. |
| get_listing | { slug } | Fetch one listing by URL slug, including its active opportunities. |
| get_destination_stats | { slug } | Get aggregate stats for a country (listing count, city count, opportunity count). |
| list_destinations | {} | Return all destinations with active programs and their counts. |
Example invocations
// "Find hotels in Thailand with creator programs."
{ "name": "search_collabs", "arguments": { "country": "thailand", "type": "hotel" } }
// "Which countries have the most travel creator collabs?"
{ "name": "list_destinations", "arguments": {} }
// "Tell me about Indonesia."
{ "name": "get_destination_stats", "arguments": { "slug": "indonesia" } }
// "Show me wolo-travel."
{ "name": "get_listing", "arguments": { "slug": "wolo-travel" } }Configuration
| Env var | Default | Purpose |
|---|---|---|
| COLLABSMAP_API_BASE | https://collabsmap.com/api/v1 | Override for local development against a non-production deployment. |
Rate limits
The CollabsMap public API enforces an IP-based rate limit of 100 requests per hour. The server surfaces X-RateLimit-* headers to clients, and when limited returns a CollabsApiError with status: 429 and (when available) retry_after_seconds. Most agents don't fan out wildly, so this is plenty for interactive use.
Issues
Found a bug or have a feature request? Get in touch via https://collabsmap.com.
License
MIT
