# Travel Companions

> Travel Companions helps people find a travel buddy. Anyone, including AI agents, can search trips and travelers publicly with masked details (first name + last initial, age range, home city). People connect only after both sides accept, and contact details are shared only between ID-verified travelers. It is agent-first: a remote MCP server and a REST API expose the same tools.

- Free public search, no account needed: search_trips, search_travelers, get_trip, list_popular_destinations.
- Trust ladder: 0 public search · 1 account (post trips, matches) · 2 accepted Terms + 18+ (connect, message) · 3 ID verified (contact exchange).
- Every error includes `nextStep`, an instruction an agent can follow (which tool to call, which link to show).
- Match results include a one-sentence `why` that can be read to the user as-is.

## Connect an agent

- [MCP server (Streamable HTTP)](https://travel.coticsy.com/mcp): public tools without auth; OAuth 2.1 + PKCE or X-API-Key for account tools. [https://travel.coticsy.com/mcp/auth](https://travel.coticsy.com/mcp/auth) requires OAuth at connect time.
- [OpenAPI 3.1](https://travel.coticsy.com/openapi.json): REST API; every MCP tool is POST /v1/tools/{name}, plus GET aliases like /v1/trips?to.city=Lisbon&to.country=PT
- [Developer docs](https://travel.coticsy.com/docs): quickstart, auth, errors, webhooks, rate limits
- [MCP server card](https://travel.coticsy.com/.well-known/mcp/server-card.json) · [A2A agent card](https://travel.coticsy.com/.well-known/agent-card.json) · [API catalog](https://travel.coticsy.com/.well-known/api-catalog)
- [OAuth metadata](https://travel.coticsy.com/.well-known/oauth-authorization-server)

## Public tools

- search_trips (public): Find travelers looking for companions. Works without an account. Filter by destination, origin, dates, needs (share_room, split_costs...), languages, sex, age range. Free text `q` matches plans and interests semantically. Results are ranked by compatibility and include masked traveler cards (first name + initial, age range, city).
- search_travelers (public): Browse masked traveler cards (not trip posts). Filter by destination of their open trips, languages, age, nationality, interests, or free text. Useful when the user asks who is going somewhere rather than for a specific date window.
- get_trip (public): Get the public view of one trip by id, including the masked traveler card.
- get_traveler_card (public): Get the public, masked card of a traveler by their public id.
- list_popular_destinations (public): Destinations with the most open trips right now. Useful to suggest where companions are easiest to find.
- list_needs_taxonomy (public): Suggested `needs` tags. Any snake_case tag is accepted, but these are the common ones.
- get_my_status (public): Tells the agent what the current user can do: trust level, plan, whether a profile exists, and the next steps to unlock more (create profile, accept terms, verify ID).

## Browse

- [Popular destinations](https://travel.coticsy.com/destinations): open trips by city, each trip has a public page at https://travel.coticsy.com/t/{tripId}
- [Trip search as JSON](https://travel.coticsy.com/v1/trips?to.city=Lisbon&to.country=PT): example anonymous query

## Policies

- [Terms of Service](https://travel.coticsy.com/terms): 18+ only; agents must act with the user's authorization
- [Privacy Policy](https://travel.coticsy.com/privacy): what is public, masked and private
- [Consent flow](https://travel.coticsy.com/consent) · [ID verification](https://travel.coticsy.com/verify)

## Optional

- [Full tool reference](https://travel.coticsy.com/llms-full.txt): every tool, its access level and arguments