Skip to content
Works today

Build and publish websites with Hermes Agent

Hermes Agent speaks MCP and OAuth natively, so adding Kleap is a few lines of config. After that you can ask Hermes for a website, a fix, a publish or a week of SEO work, and Kleap does the hosting.

Through MCP, and through skills installed from their raw URL.

What you can ask Hermes Agent to do

Kleap is an AI website builder. Your agent gives the instructions, Kleap builds, hosts and publishes.

  • Build a site from a sentence

    Your agent asks Kleap for a site. Kleap's AI builds it, with hosting, SSL and forms included, and returns a task the agent follows until it is done.

  • Edit what already exists

    Find a site by name, address or domain, read its files, change exactly what must change, and keep the rest untouched. Or describe the outcome and let Kleap's AI write it.

  • Publish with proof it is live

    A publish is reported as done only once the new version is actually serving at its URL. Your agent never hands you a dead link.

  • Improve SEO, once or on a schedule

    Read Google Search Console numbers, find the pages that deserve work, rewrite titles and copy, publish, and report. The same prompt can run every day.

  • Read leads and traffic

    Form submissions, visitors, pageviews and top pages come back as plain data your agent can summarise, answer or act on.

  • Domains, without surprise bills

    The agent can search and connect domains. Buying one always goes through a payment link that you pay yourself, so nothing is bought on its own.

Connect Kleap to Hermes Agent

Hermes registers itself with Kleap, runs the sign-in and refreshes the token for you. You edit one file.

  1. Add Kleap to ~/.hermes/config.yaml

    mcp_servers is a map keyed by server name. Setting auth: oauth tells Hermes to handle discovery, client registration, PKCE and token refresh itself.

    ~/.hermes/config.yaml
    mcp_servers:
      kleap:
        url: "https://kleap.co/api/mcp"
        auth: oauth
  2. Sign in and reload

    Hermes opens a browser on first connect when it can, and offers a paste-back flow on a headless host. Tokens are cached under ~/.hermes/mcp-tokens/. Reload the servers in a running session, or restart Hermes.

    Terminal
    hermes mcp login kleap
    Inside Hermes
    /reload-mcp
  3. Optional: add the Kleap skills

    Hermes installs a skill from the URL of its SKILL.md. Install the three you need most.

    Terminal
    hermes skills install https://raw.githubusercontent.com/kleaphq/skills/main/kleap-build/SKILL.md
    hermes skills install https://raw.githubusercontent.com/kleaphq/skills/main/kleap-edit/SKILL.md
    hermes skills install https://raw.githubusercontent.com/kleaphq/skills/main/kleap-publish/SKILL.md
  4. For an unattended agent: use a key

    A scheduled job has nobody to click through a browser. Create a Kleap API key at https://kleap.co/settings/api-key, pick the narrowest preset, and send it as a bearer header instead of OAuth.

    ~/.hermes/config.yaml
    mcp_servers:
      kleap:
        url: "https://kleap.co/api/mcp"
        headers:
          Authorization: "Bearer kleap_live_sk_..."

Prompts to try in Hermes Agent

Copy one, change the details to yours, and send it. Each one names what you want and what done looks like.

Build a site

Use Kleap to build a website for my yoga studio: class schedule, teachers, pricing and a booking request form. Calm colours. Publish it and send me the link.

Update the schedule

On my Kleap yoga site, replace the class schedule with the table below, keep the styling, publish and confirm the page is live.

SEO pass

Check my Kleap site's Google Search data, pick the page with the most impressions and the weakest title, improve its title, description and intro for the query it ranks for, publish, and tell me what changed.

Weekly report

Every Monday, send me last week's visitors, top pages and new form leads for my Kleap site, in five lines.

SEO on a schedule

Let Hermes run it on its own cron

Hermes has built-in scheduled tasks: you can ask it in chat to run a prompt every day, or create a cron job. Jobs run unattended, so give Kleap only what the job needs: a Read-only or Build key, and the prompt below.

Scheduled prompt

Every morning, go through my Kleap sites one by one. For each site: 1. Read the last 28 days with get_search_console and get_analytics. 2. Pick the one page with the most impressions that still sits between position 5 and 20, or whose title does not match the query it ranks for. 3. Read that page with read_files and improve its title, meta description, H1, intro, internal links and FAQ so they answer that query better, in the site's own voice. 4. Push the change with write_files, then publish_app and confirm with get_publish_status. 5. Send me a summary: site, page, query, what changed. Never invent statistics or testimonials, never change a site's design, and touch at most two pages per site per run.

Google Search Console must be connected to the site for the search data. If it is not, Kleap hands the agent a consent link for you to open.

Good to know

  • Hermes documents editing config.yaml for arbitrary remote servers; we found no generic hermes mcp add --url command, so the steps above use the file.
  • Each Kleap skill is its own SKILL.md. The other two, kleap-data and kleap-multilingual, install the same way from the same repository.
  • Domain purchases always go through a payment link that you pay yourself.

Official documentation: MCP in Hermes Agent (docs).

Hermes Agent and Kleap: questions

Does Hermes Agent work with Kleap?

Yes. Hermes supports remote HTTP MCP servers with OAuth, and Kleap's server supports OAuth with dynamic client registration. Add the entry to config.yaml, sign in once, and the Kleap tools appear next to Hermes' own.

Do I need the skills if I have the MCP server?

No. The server alone is enough. The skills add a tested order of calls for building, editing and publishing.

Can I use the CLI instead of MCP?

Yes. Hermes can run shell commands, and npx -y kleap-cli covers create, edit, publish, files, forms, analytics and domains with one-to-three-line output.

Is it safe to run this on a cron?

Treat it like any unattended agent: use the narrowest Kleap key, ask for a summary after every run, and start with a Read-only key to watch what it proposes. If a publish cannot be confirmed live, Kleap rolls back and says so instead of reporting success.

Do I need an API key?

No. The connector signs you in with OAuth in your browser, so there is nothing to copy. An API key (kleap_live_sk_…, created at https://kleap.co/settings/api-key) is only for unattended jobs, scripts and clients that cannot open a browser. Pick the narrowest preset: Read-only to inspect sites, Build to change and publish them.

Does it cost anything to connect Kleap?

Connecting is free. Building and AI edits draw on your Kleap usage, and the free plan includes some. If your agent writes the files itself with write_files, Kleap does not run its own AI for that step. Publishing on a Kleap address is free. See the pricing page for each plan.

Using another agent?

Same Kleap account, same sites. See all the agent guides or the MCP, CLI and skills reference.

Put Hermes Agent to work on your website

Connect once, then ask in plain words. Kleap builds, hosts and publishes, and your agent keeps the site improving.

Free to start. See pricing