Beyond MCP Server¶
The Beyond MCP server connects AI agents to Beyond over the Model Context Protocol. Once connected, an agent such as Claude or ChatGPT can look up a user's listings, read their performance, calendars, reservations, and market data, change pricing settings, and ask Neyoba, Beyond's AI agent, for analysis and recommendations.
The agent acts on behalf of the Beyond user who connected it: it sees and changes only what that user's Beyond login can see and change.
Quick start¶
| Item | Value |
|---|---|
| MCP server URL | https://neyoba.beyondpricing.com/mcp |
| Transport | Streamable HTTP |
| Authorization | OAuth 2.0 Authorization Code with PKCE and Dynamic Client Registration |
Add https://neyoba.beyondpricing.com/mcp as a remote MCP server (a "custom
connector") in your MCP client. The client registers itself, opens the Beyond
sign-in and consent page, and stores the resulting tokens; no API credentials
have to be created first. Connecting describes the OAuth flow
step by step for client developers.
Scopes¶
Each tool requires exactly one OAuth scope. The consent page lists the scopes the client requested; the tools a connection can see and call are the ones its granted scopes allow.
| Scope | Grants | Tools |
|---|---|---|
beyond:read |
Read listings, settings, calendars, performance, reservations, and market data | Listings and data |
beyond:write |
Change pricing and stay-rule settings, and create groups and saved filters | Pricing changes, Groups and saved filters |
neyoba:ask |
Ask Neyoba, Beyond's AI agent | Neyoba |
beyond:skills |
Load Beyond's revenue-management skills | Skills |
beyond:usage |
Read the account's usage and the audit trail of MCP tool calls | Usage and audit |
Usage¶
Every tool call counts toward the Beyond account's monthly usage allocation.
When the allocation (or, on plans with overage, the monthly overage budget) is
exhausted, tool calls are refused with an error until the allocation resets.
Tool calls are also refused when the account's Beyond plan does not include
MCP server access.
The get_usage tool reports the current month's
consumption, so an agent can check it before a large bulk operation.
In this section¶
| Page | Description |
|---|---|
| Connecting | OAuth 2.0 discovery, client registration, consent, token refresh, and revocation |
| Tools | Every tool the server exposes, grouped by purpose, with its scope |