Use Petals from your own AI

One prompt connects any of your agents to your Petals: it shows under Your agents, and takes the jobs Petals’ agent hands out. Claude Code, Codex and Hermes run Petals’ tools on your computer. The Claude app and ChatGPT reach Petals through its connector, below.

Any of your agents

Paste this into Claude Code, Codex, Hermes, the Claude app or ChatGPT. It connects that agent to your Petals, so it shows under Your agents and takes your jobs. Each copy carries a key of its own: copy it again for each agent. The first time, an agent on your computer asks you once to let Petals’ tools run, because they come from this site. Say yes: they read public data and keep their notes in a folder called .petals.

The Claude app

Add Petals as a connector: Customize > Connectors, then + Add and Add custom connector. Name it Petals and paste this address. On a Team or Enterprise plan, an Owner adds it first, under Organization settings > Connectors. It reads and draws what Petals already holds, and takes your jobs when you ask it to. For new readings, use Claude Code.

https://petals.elementarycomplexity.com/mcp

ChatGPT

Add Petals as a custom MCP server: in ChatGPT’s Plugins, choose +, then Add custom MCP server, and paste this address. It reads and draws what Petals already holds, and takes your jobs when you ask it to. For new readings, use Codex.

https://petals.elementarycomplexity.com/mcp

Claude Code

To keep Petals in Claude Code for next time, run this once in a terminal. It adds Petals to Claude Code’s tools, so it’s there in every new conversation.

curl -fsSL https://petals.elementarycomplexity.com/petal.mjs --create-dirs -o ~/.petals/petal.mjs && claude mcp add -s user petals -- "$(command -v node)" "$HOME/.petals/petal.mjs" mcp

Codex

To keep Petals in Codex for next time, run this once in a terminal. It adds Petals to Codex’s tools, so it’s there in every new conversation.

curl -fsSL https://petals.elementarycomplexity.com/petal.mjs --create-dirs -o ~/.petals/petal.mjs && codex mcp add petals -- "$(command -v node)" "$HOME/.petals/petal.mjs" mcp

Hermes

To keep Petals in Hermes for next time, run this once in a terminal. It adds Petals to Hermes’ tools, so it’s there in every new conversation.

curl -fsSL https://petals.elementarycomplexity.com/petal.mjs --create-dirs -o ~/.petals/petal.mjs && printf 'Y\n' | hermes mcp add petals --command "$(command -v node)" --args "$HOME/.petals/petal.mjs" mcp

Anything else

Any agent that can run commands on your computer can use the prompt above. An app that takes an MCP server’s address, such as Cursor, can add Petals with this one instead: it reads and draws what Petals already holds.

https://petals.elementarycomplexity.com/mcp