voyal

Voyal / MCP

MCP server

The MCP server is a stateless Streamable HTTP endpoint at https://app.voyal.link/mcp. It identifies itself as links version 0.3.0. A connection accepts a Clerk OAuth access token or a Clerk API key, and acts on one organization.

Connect with OAuth

Add the server URL in Claude, Cursor, or any MCP client that supports remote OAuth. The client discovers the authorization server from this origin and asks you to sign in. The consent screen asks which organization to grant. That organization is the only one the connection can use. To work in another organization, add another account in the client.

Requested scopes: profile, email, user:org:read.

Claude Code

claude mcp add --transport http links https://app.voyal.link/mcp

Connect with an API key

For a client without OAuth, create a key in the app while the organization is active. Open MCP & API and create a key there. Keys created while an organization is active belong to that organization. Send the key as a bearer token. The same key also authenticates the REST API at /api/links and /api/domains.

The command below uses the placeholder <API_KEY>. Replace it with a key from your account. It is not a working credential, and a real key should not be committed or pasted into a public page.

claude mcp add --transport http links https://app.voyal.link/mcp --header "Authorization: Bearer <API_KEY>"

add_domain and update_domain require an organization admin. An organization API key counts as an admin. The other link tools are available to members.

Tools

These are the tools the server registers. Names and descriptions match that registration.

  1. list_domains — List custom domains

    List your custom domains.

    Input. No inputs. Read-only.

  2. add_domain — Add custom domain

    Register a hostname on this organization. Requests for it are matched to the organization. The hostname must also be routed to the Voyal Worker.

    Input. hostname, for example go.example.com. Organization admins only. An organization API key counts as an admin.

  3. update_domain — Update custom domain

    Set where unknown slugs redirect. To configure the root URL, create or update the "_root" link on the domain.

    Input. domain (id or hostname) and notFoundUrl. null shows a 404. Organization admins only.

  4. get_organization — Get organization

    The organization this connection acts on (chosen when signing in). Connect another account to use another organization.

    Input. No inputs. Read-only. Returns id, name, slug, and role ("admin" or "member").