MCP Server

Connect AI agents to Osoto using the Model Context Protocol. Create trips, manage itineraries, and send messages directly from Claude, Cursor, or any MCP-compatible client.

Getting started

The Osoto MCP server wraps the REST API as native tools. You need an API key. Generate one in Settings → API Keys.

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "osoto": {
      "command": "npx",
      "args": ["@osoto/mcp-server"],
      "env": {
        "OSOTO_API_KEY": "osk_your_key_here",
        "OSOTO_API_URL": "https://keen-sturgeon-487.convex.site/api/v1"
      }
    }
  }
}

Claude Code

claude mcp add osoto -- npx @osoto/mcp-server

Set OSOTO_API_KEY and OSOTO_API_URL in your environment before running.

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "osoto": {
      "command": "npx",
      "args": ["@osoto/mcp-server"],
      "env": {
        "OSOTO_API_KEY": "osk_your_key_here",
        "OSOTO_API_URL": "https://keen-sturgeon-487.convex.site/api/v1"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "osoto": {
      "command": "npx",
      "args": ["@osoto/mcp-server"],
      "env": {
        "OSOTO_API_KEY": "osk_your_key_here",
        "OSOTO_API_URL": "https://keen-sturgeon-487.convex.site/api/v1"
      }
    }
  }
}

Other MCP clients

Any MCP-compatible client can connect. Run the server with:

OSOTO_API_KEY=osk_... OSOTO_API_URL=https://keen-sturgeon-487.convex.site/api/v1 npx @osoto/mcp-server

Available tools

The MCP server exposes the following tools to your agent:

Tool	Description
osoto_list_trips	List all trips the user has access to
osoto_create_trip	Create a new trip with title, dates, and group
osoto_get_trip	Get trip details
osoto_update_trip	Update trip title, dates, or status
osoto_list_legs	List itinerary legs for a trip
osoto_add_leg	Add a trip leg with destination, dates, and logistics
osoto_update_leg	Update a trip leg
osoto_remove_leg	Remove a trip leg
osoto_list_action_items	List checklist items for a trip
osoto_add_action_item	Add a checklist item with urgency level
osoto_toggle_action_item	Toggle an item complete/incomplete
osoto_list_map_pins	List map pins for a trip
osoto_add_map_pin	Pin a place on the trip map
osoto_send_message	Send a message to a trip channel
osoto_list_members	List members of a trip

Resources

The server also exposes MCP resources for browsing trip data:

URI	Description
osoto://trips	List of all trips
osoto://trips/{tripId}	Full trip state: legs, action items, map pins, and members