Joyrise

Official Joyrise MCP server: set up your website, read SEO articles and search results, change article settings, and pause or publish. Joyrise writes and publishes SEO articles on your site every day.

Hosted MCP Server

npx add-mcp 'https://api.joyrise.ai/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

On this page

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 Joyrise to Cursor, or add this to ~/.cursor/mcp.json. Then sign in when Cursor asks:

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

VS Code

Add Joyrise to VS Code, or 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

ToolWhat it doesChanges anything
get_accountYour websites, plan, and whether publishing is paused or setup is finished.No
get_dashboardArticle counts, the next article date, first-article progress, and what is connected.No
list_articlesArticles written so far, or the planned queue with dates.No
read_articleOne article as markdown.No
get_search_performanceSearch Console clicks, impressions, CTR and position, best articles, top searches.No
get_visitorsGoogle Analytics visitors, channels and top pages.No
get_site_healthThe hourly SEO checkup and recent activity.No
list_fixesWhat Fix with Joy fixed, is fixing, and couldn't fix.No
get_profileBusiness name, description, audiences and competitors.No
get_article_settingsFormats, formatting and link settings.No
add_websiteScan a website and start setting it up.Yes
update_profileChange the business profile.Yes
start_writingFinish setup: Joyrise starts writing.Yes
choose_first_topicPick the topic of the first article.Yes
update_article_settingsChange formats, formatting and link settings.Yes
set_publishingPause or resume publishing.Yes
publish_draftPublish a draft to your CMS now.Yes
fix_nowStart fixing failing SEO checks now.Yes
publish_fixesPublish your Webflow site so Joy's page fixes go live.Yes
undo_fixUndo one of Joy's fixes.Yes
start_checkoutA 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.