Koskamo

Yoya MCP

Yoya MCP enables AI agents to book meetings on a host's real availability via a public endpoint without requiring guest sign-in. It supports scheduling across time zones and integrates with tools like Claude Code and Cursor for remote configuration and booking walkthroughs.

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.

Yoya MCP logo, by YoyaCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by Yoya
MCP endpoint (Streamable HTTP)
https://yoya.ai/api/mcp/book
Vendor documentation

What its tools do

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

Read-only (4)

Can change data (3)

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

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Book meetings on a host's real availability
  • Connect and inspect available tools in Claude Code
  • Remote MCP configuration and booking walkthrough in Cursor
  • Book across time zones for customer interviews

Source and maintenance

Community listingRegistry 1.0.0
mcp-registry: io.github.makloai/yoya-booking@1.0.0Project website

Protocol and capabilities

Server
yoya-booking 2.0.0
MCP protocol negotiated in check
2025-11-25
Tools
7 advertised
Resources
1 advertised
Resource templates
0 advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Tools

7 advertised

get_booking_page — Get a Yoya booking page
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read a public Yoya booking link or slug. Includes required guest fields and meeting options. No host account access.

get_booking_page input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    }
  }
}
get_booking_page output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextOffset": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "syncStatus": {
      "enum": [
        "pending",
        "ready",
        "attention"
      ],
      "type": "string"
    }
  },
  "additionalProperties": {}
}
get_booking_page annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_available_times — Find available meeting times
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Find up to 10 times (max 50), labeled in the guest's IANA timezone. Filter by inclusive from/exclusive to datetimes and morning (06–12), afternoon (12–18) or evening (18–24) in the guest timezone. Pass nextCursor unchanged to continue with the same filters. Slots are suggestions; preview then book rechecks availability. Never invent slot IDs.

list_available_times input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "slug"
  ],
  "properties": {
    "to": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "from": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "slug": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1
    },
    "cursor": {
      "type": "string",
      "pattern": "^s_\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}Z$"
    },
    "timezone": {
      "type": "string",
      "maxLength": 100
    },
    "timeOfDay": {
      "enum": [
        "morning",
        "afternoon",
        "evening"
      ],
      "type": "string"
    }
  }
}
list_available_times output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextOffset": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "syncStatus": {
      "enum": [
        "pending",
        "ready",
        "attention"
      ],
      "type": "string"
    }
  },
  "additionalProperties": {}
}
list_available_times annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
preview_booking — Review a booking before confirming
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Validate guest details and the selected time without booking or sending email. Show the returned summary to the guest and ask for explicit approval. Then call book_meeting with the returned normalized booking, requestId and confirmationToken.

preview_booking input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "slug",
    "name",
    "email",
    "slotId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "slug": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "email": {
      "type": "string",
      "maxLength": 320
    },
    "slotId": {
      "type": "string",
      "pattern": "^s_\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}Z$"
    },
    "purpose": {
      "type": "string",
      "default": "",
      "maxLength": 2000
    },
    "timezone": {
      "type": "string",
      "maxLength": 100
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Reuse the ID returned by preview_booking for retries."
    },
    "meetingType": {
      "enum": [
        "google_meet",
        "zoom",
        "in_person"
      ],
      "type": "string"
    },
    "fieldAnswers": {
      "type": "object",
      "propertyNames": {
        "type": "string",
        "maxLength": 60,
        "minLength": 1
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 2000
      }
    },
    "meetingFormat": {
      "type": "string",
      "maxLength": 1000,
      "description": "Copy the value from preview_booking unchanged."
    }
  }
}
preview_booking output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextOffset": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "syncStatus": {
      "enum": [
        "pending",
        "ready",
        "attention"
      ],
      "type": "string"
    }
  },
  "additionalProperties": {}
}
preview_booking annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
book_meeting — Confirm a reviewed meeting
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

Creates a free booking or returns PAYMENT_REQUIRED with a secure payment URL for paid meetings. Paid meetings are not booked until payment succeeds; show the link and never claim confirmation before that. Only call after the guest explicitly approves preview_booking. Copy the preview's booking fields and confirmationToken unchanged. Reuse requestId and token on network retries; never claim notifications are delivered until syncStatus is ready.

book_meeting input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "slug",
    "name",
    "email",
    "slotId",
    "confirmationToken",
    "confirmed"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "slug": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "email": {
      "type": "string",
      "maxLength": 320
    },
    "slotId": {
      "type": "string",
      "pattern": "^s_\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}Z$"
    },
    "purpose": {
      "type": "string",
      "default": "",
      "maxLength": 2000
    },
    "timezone": {
      "type": "string",
      "maxLength": 100
    },
    "confirmed": {
      "type": "boolean",
      "const": true
    },
    "requestId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Reuse the ID returned by preview_booking for retries."
    },
    "meetingType": {
      "enum": [
        "google_meet",
        "zoom",
        "in_person"
      ],
      "type": "string"
    },
    "fieldAnswers": {
      "type": "object",
      "propertyNames": {
        "type": "string",
        "maxLength": 60,
        "minLength": 1
      },
      "additionalProperties": {
        "type": "string",
        "maxLength": 2000
      }
    },
    "meetingFormat": {
      "type": "string",
      "maxLength": 1000,
      "description": "Copy the value from preview_booking unchanged."
    },
    "confirmationToken": {
      "type": "string",
      "maxLength": 1000
    }
  }
}
book_meeting output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextOffset": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "syncStatus": {
      "enum": [
        "pending",
        "ready",
        "attention"
      ],
      "type": "string"
    }
  },
  "additionalProperties": {}
}
book_meeting annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}
get_booking — Check a booking
Advertised by the server during the last successful anonymous check.
Advertised read-only

Read a booking using its private manage-link token. Includes meeting-link synchronization status. Treat this token as a password; do not share it publicly.

get_booking input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    }
  }
}
get_booking output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextOffset": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "syncStatus": {
      "enum": [
        "pending",
        "ready",
        "attention"
      ],
      "type": "string"
    }
  },
  "additionalProperties": {}
}
get_booking annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
cancel_booking — Cancel a booking
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

Cancel using a private manage token. Ask the guest for explicit approval first; this sends cancellation notifications.

cancel_booking input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "token",
    "confirmed"
  ],
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "reason": {
      "type": "string",
      "maxLength": 500
    },
    "confirmed": {
      "type": "boolean",
      "const": true
    }
  }
}
cancel_booking output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextOffset": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "syncStatus": {
      "enum": [
        "pending",
        "ready",
        "attention"
      ],
      "type": "string"
    }
  },
  "additionalProperties": {}
}
cancel_booking annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": true
}
reschedule_booking — Reschedule a booking
Advertised by the server during the last successful anonymous check.
Advertised destructiveOpen-world

Move a booking using its private manage token and a fresh slot ID from list_available_times. Ask for explicit approval first. The original booking stays intact if the new time cannot be reserved.

reschedule_booking input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "token",
    "slotId",
    "confirmed"
  ],
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "reason": {
      "type": "string",
      "maxLength": 500
    },
    "slotId": {
      "type": "string",
      "pattern": "^s_\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}Z$"
    },
    "confirmed": {
      "type": "boolean",
      "const": true
    }
  }
}
reschedule_booking output schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ok"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "code": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "nextOffset": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "syncStatus": {
      "enum": [
        "pending",
        "ready",
        "attention"
      ],
      "type": "string"
    }
  },
  "additionalProperties": {}
}
reschedule_booking annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

Yoya booking

Advertised by the server during the last successful anonymous check.

Choose times, review details and explicitly confirm a booking.

Yoya booking URI
ui://yoya/booking.html

MIME type: text/html;profile=mcp-app

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
758 ms
95th percentile latency
758 ms

Maintenance history

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

  • · probe · passed · 758 ms · metadata changed · 7 tool(s), 1 resource(s), 0 resource template(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 yoya-mcp https://yoya.ai/api/mcp/book

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 yoya-mcp --url https://yoya.ai/api/mcp/book

Cursor

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

Cline

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

VS Code

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

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 yoya-mcp https://yoya.ai/api/mcp/book

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://yoya.ai/api/mcp/book

Windsurf

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

Let your agent find its tools

Find servers like Yoya 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,453