yaya

Connect an agent with MCP

Point an MCP client at the yaya-mcp server so an agent can publish and manage your site.

Last updated

Before you start

  • The yaya-mcp binary from the @yaya/mcp package.
  • A key saved by yaya login key. See Use the yaya CLI.

Connect your agent

  1. Run yaya login key once and save a key.
  2. Add yaya-mcp to your MCP client as a stdio server.
  3. Restart the client.
  4. Ask the agent to call yaya_get_openapi. A response means it is connected.

The server reads the same credentials file as the CLI. One login covers both.

What the agent can do

The server has tools for these jobs:

  • Publish a folder, or a site draft, to a workspace.
  • List, read and check the live files of a site.
  • List, restore and delete site versions.
  • Read and update your profile and vanity subdomain.
  • Search and check domains, and manage mounts.
  • Read analytics, change account email and manage payment methods, when the key has the scope.

Each tool needs a key with the matching scope. See MCP tool reference for every tool and API scopes and rate limits.

Errors

A failed tool call returns JSON with the HTTP status and the error code. A rate limit includes retryAfterSeconds, so the agent can wait instead of retrying at once.

Was this guide helpful?

Still stuck? Email support@yaya.page.

Related guides