Joyrise

Use Joyrise from an AI assistant (MCP)

Updated · This page as markdown

On this page
  1. Connect
  2. Sign in
  3. Things to ask
  4. Tools
  5. Good to know
  6. For developers

Joyrise has an MCP server, so Claude, ChatGPT, Cursor and other AI assistants can run your Joyrise account for you: set up a website, read your articles and numbers, change settings, and pause or publish. You sign in with your Joyrise account. There are no API keys.

Server URL: https://api.joyrise.ai/mcp

New to Joyrise? Start with the docs. You can also create your account during the first sign-in below.

Connect

Claude (claude.ai and the desktop app)

Open Settings › Connectors, choose Add custom connector, name it Joyrise and paste the server URL. Then connect and sign in. On a Team or Enterprise plan, an owner may need to add the connector first.

Claude Code

claude mcp add --transport http joyrise https://api.joyrise.ai/mcp

Then run /mcp in Claude Code, pick joyrise, and sign in in the browser.

ChatGPT

Add a custom connector with the server URL (in Settings, under Apps or Connectors; developer mode may need to be on), then sign in.

Cursor

Add this to ~/.cursor/mcp.json, then sign in when Cursor asks:

{ "mcpServers": { "joyrise": { "url": "https://api.joyrise.ai/mcp" } } }

VS Code

Add this to .vscode/mcp.json, then start the server and sign in:

{ "servers": { "joyrise": { "type": "http", "url": "https://api.joyrise.ai/mcp" } } }

Any other assistant

Most MCP clients that support remote servers (Streamable HTTP) with OAuth sign-in work with the server URL; they find the sign-in through the server's protected resource metadata (see For developers).

Sign in

The first time the assistant uses Joyrise, it opens Joyrise's sign-in page. Sign in, or create an account, and approve access. To stop an assistant using your account, remove the connector in it. Joyrise doesn't list connected assistants yet; to have one cut off for good, email brian@joyrise.ai.

Things to ask

  • "Set up Joyrise for acme.com."
  • "How did my articles do in search this month?"
  • "What is Joyrise writing next?"
  • "Before my first article is written, make it about treasury management for startups."
  • "Turn off tables in my articles and never mention competitor.com."
  • "Pause publishing."
  • "Is anything wrong with my site's SEO?"

Tools

Tool What it does Changes anything
get_account Your websites, plan, and whether publishing is paused or setup is finished. No
get_dashboard Article counts, the next article date, first-article progress, and what is connected. No
list_articles Articles written so far, or the planned queue with dates. No
read_article One article as markdown. No
get_search_performance Search Console clicks, impressions, CTR and position, best articles, top searches. No
get_visitors Google Analytics visitors, channels and top pages. No
get_site_health The hourly SEO checkup and recent activity. No
list_fixes What Fix with Joy fixed, is fixing, and couldn't fix. No
get_profile Business name, description, audiences and competitors. No
get_article_settings Formatting and link settings. No
add_website Scan a website and start setting it up. Yes
update_profile Change the business profile. Yes
start_writing Finish setup: Joyrise starts writing. Yes
choose_first_topic Pick the topic of the first article. Yes
update_article_settings Change formatting and link settings. Yes
set_publishing Pause or resume publishing. Yes
publish_draft Publish a draft to your CMS now. Yes
fix_now Start fixing failing SEO checks now. Yes
publish_fixes Publish your Webflow site so Joy's page fixes go live. Yes
undo_fix Undo one of Joy's fixes. Yes
start_checkout A Stripe link for you to open to choose or change a plan. Yes

Good to know

  • One website per account. Tools act on it unless you name another domain.
  • Your first article is free and waits as a draft; the assistant sees its first 80%. Choosing a plan happens on a Stripe page the assistant links you to. It cannot pay for you.
  • Connections stay in the app. Webflow, WordPress, Shopify, Search Console and Google Analytics are connected in the Joyrise app, not through the assistant: a token or password pasted into a chat would stay in its history.
  • Changes ask first. Adding a website, publishing, starting or undoing Joy's fixes, and changing your profile or article settings are marked as changes, so assistants that honor those hints ask you before running them.
  • Results are data. Assistants are told that what Joyrise returns (page titles, search queries, article text) is information, not instructions.
  • Plain-language errors. When something can't be done, such as publishing before a plan starts, the assistant gets the reason in words and can tell you.

For developers

  • Transport: Streamable HTTP, stateless. Each POST carries one JSON-RPC message (or a batch of up to 10 for protocol 2025-03-26) and gets one JSON response. There is no server-sent stream: GET answers 405.
  • Protocol versions: 2024-11-05 through 2025-11-25. Tools only; no resources or prompts.
  • Auth: OAuth 2.1 with PKCE, through Joyrise's sign-in at https://clerk.joyrise.ai, with dynamic client registration. Protected resource metadata: https://api.joyrise.ai/.well-known/oauth-protected-resource/mcp. A request without a valid token gets 401 with a WWW-Authenticate header pointing there.
  • Errors: a tool that can't complete answers a normal result with isError: true and a plain-language reason.

Wake up to new visitors tomorrow.

Joyrise plans, writes and publishes SEO articles on your site every day.

No card until your first article is written.