Skip to content

joystream-ai/joystream

v0.2.0MIT

Build, ship and debug JoyStream agents through the JoyStream MCP server.

JoyStream plugin for Claude Code and Codex

Build, ship and debug JoyStream agents from your coding agent. The plugin connects Claude Code or Codex to the JoyStream MCP server and adds skills that write an agent spec, build it and try it in a Simulation before a real Run, and explain why a run failed.

What you get

  • joystream-agent-author: turns a request into a valid agent spec, using your connected services, catalog skills and connector actions.
  • joystream-agent-ship: builds a version of the agent, runs a Simulation of it, then a real Run once you approve.
  • joystream-agent-debug: finds the cause of a failed run and proposes a spec change, or says the cause is unclear.
  • The JoyStream MCP server at https://api.joystream.ai/mcp, connected when you install the plugin.
  • Confirmation for risky actions. A real Run, publishing or cloning on Agent Universe, and connector actions that change something do nothing until you approve the summary the server returns. A Simulation needs no approval: it touches nothing outside JoyStream.

Requirements

A JoyStream account. Sign up at joystream.ai.

Install

Claude Code

/plugin marketplace add joystream-ai/joystream-plugin
/plugin install joystream@joystream-ai

Or from the terminal:

claude plugin marketplace add joystream-ai/joystream-plugin
claude plugin install joystream@joystream-ai

Codex

codex plugin marketplace add joystream-ai/joystream-plugin

Then run codex, type /plugins, open the JoyStream tab and install joystream. In the ChatGPT desktop app, open the Plugins tab, find joystream and select the plus button. Start a new session to use the plugin.

Sign in

The first time the plugin uses the MCP server, your browser opens JoyStream's sign-in and consent page. Sign in and choose Approve. Your coding agent then acts with your JoyStream account's access, and nothing is stored in a config file.

  • Claude Code: run /mcp, select joystream and choose Authenticate.
  • Codex: approve the sign-in when Codex asks during install. If it doesn't, run codex mcp login joystream.

To revoke access, open Settings → Connected apps in JoyStream and select Revoke.

Example prompts

  • "Build a JoyStream agent that summarizes the latest release of acme/api on GitHub and posts it to #releases in Slack."
  • "Why did my last run of release-digest fail?"
  • "Ship release-digest: build it, run a Simulation, and do a real Run if the Simulation looks right."
  • "Run version 0.0.3 of release-digest again in a Simulation."
  • "Which of my agents failed this week, and why?"

Use the MCP server without the plugin

Skills come only with the plugin, which supports Claude Code and Codex. Any MCP client can connect to the server itself.

Claude Code

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

Then run /mcp, select joystream and authenticate.

Codex: add this to ~/.codex/config.toml:

[mcp_servers.joystream]
url = "https://api.joystream.ai/mcp"

Then sign in:

codex mcp login joystream

Claude Desktop and claude.ai: open Settings → Connectors → Add custom connector and enter https://api.joystream.ai/mcp.

Other MCP clients: add https://api.joystream.ai/mcp as a remote MCP server. In Grok, for example, open grok.com/connectors, choose New Connector → Custom and enter the URL.

What the MCP server can do

AreaCanNeeds your confirmation
ReadWorkspaces, agents, versions, specs, runs, tickets, trigger events, credit balance, connectors and their actionsNo
Build and simulateCreate and update agents, build sealed versions, run a Simulation (mode dry_run)No
RunA real Run (mode live) of the latest or a named version, publish or clone on Agent Universe, run connector actions that change somethingYes
Can'tManage members, sharing, vaults, billing or settings

It works only with what your JoyStream account can see and do. Viewers can read but not change anything.

Troubleshooting

"Endpoint not found" or 404. The server URL is wrong. It must be exactly https://api.joystream.ai/mcp.

Sign-in keeps coming back. Sign in to JoyStream in the same browser first, then authenticate again from your client. The consent page sends you to the JoyStream login when you are not signed in; after you sign in, you return to it.

"Needs authentication" or 401. The client was never signed in, or its access was revoked. Authenticate again: /mcp in Claude Code, codex mcp login joystream in Codex.

Start over. Revoke the app in Settings → Connected apps, then authenticate again from your client.

Links