---
description: Add Signal to Claude, ChatGPT, Codex or Cursor once. Your AI assistant prepares a token launch, a burn or a fee claim. Your own wallet signs.
---

# Use Signal from your AI assistant

Signal for agents lets an AI assistant or agent launch and manage a coin on Signal for you. Add it once, then say what you want in plain words: launch a coin, burn tokens, collect your fees. The assistant prepares the transaction and shows you every line of what it does. **You sign in your own wallet.** Signal holds no key and sends nothing for you.

The address is always `https://signal.family/mcp`. It is free, with no key and no sign-in. If a page gives you another address, it is not Signal.

Today it works on **HyperEVM**. Elysium is not switched on here yet: to launch there, use the [launch page](https://signal.family/launch).

## Add it

In Claude Code it is one line:

```text
claude mcp add --transport http signal https://signal.family/mcp
```

In other apps:

| App | Steps |
| --- | --- |
| Claude (web, desktop, phone) | Customize → Connectors → Add → Add custom connector. Name: `Signal`. URL: `https://signal.family/mcp`. No sign-in. |
| ChatGPT | Settings → developer mode → add a custom connector with the URL `https://signal.family/mcp`. Which plans may use tools that prepare actions changes: see ChatGPT's own help page. |
| Codex | `codex mcp add signal --url https://signal.family/mcp`, or in `config.toml`: `[mcp_servers.signal]` then `url = "https://signal.family/mcp"` |
| Cursor and other MCP apps | In `mcp.json`: `{ "mcpServers": { "signal": { "url": "https://signal.family/mcp" } } }` |
| Anything else | Plain HTTPS: `POST https://signal.family/agent/v1/<tool>` with a JSON body. The schema is [openapi.json](https://signal.family/agent/openapi.json). |

Apps move their menus. If a step no longer matches, look for "connectors" or "MCP servers" in the app's settings, or use the app's own help page.

## Say it

- "Launch a coin on Signal called Moon Orchard, ticker MORCH. All fees to me. My wallet is 0x…"
- "Burn half of my MORCH."
- "Collect my creator fees from MORCH."

The assistant asks for anything it needs, such as your wallet address or the coin's picture, and never guesses them.

## What it can do

| You want to… | The assistant uses |
| --- | --- |
| Launch a coin with its picture, fee and launch protection | [`signal_upload_document`](tools/signal_upload_document.md), then [`signal_prepare_launch`](tools/signal_prepare_launch.md) |
| Check a name and ticker first | [`signal_check_name`](tools/signal_check_name.md) |
| Burn tokens you hold | [`signal_prepare_burn`](tools/signal_prepare_burn.md) |
| Collect your creator fees or holder rewards | [`signal_prepare_claim`](tools/signal_prepare_claim.md) |
| Change where your coin's fee goes | [`signal_prepare_split_change`](tools/signal_prepare_split_change.md), then [`signal_prepare_activate_change`](tools/signal_prepare_activate_change.md) a day later |
| Lock or vest tokens | Step 1: [`signal_prepare_lock`](tools/signal_prepare_lock.md) prepares your own lock contract. No token moves yet. Step 2: [`signal_prepare_lock_fund`](tools/signal_prepare_lock_fund.md) prepares moving the tokens in. Then [`signal_prepare_lock_release`](tools/signal_prepare_lock_release.md) prepares a release to the lock's receiver when the schedule allows it. Locked tokens cannot come back before the schedule, even for you. |
| Show which other wallets are yours on your coin's page | [`signal_prepare_declared_set`](tools/signal_prepare_declared_set.md) and its two next steps |
| Read a coin, or what happened to a transaction | [`signal_coin`](tools/signal_coin.md), [`signal_status`](tools/signal_status.md) |

Every tool with its fields and a worked example: [the tools](tools/README.md).

## What you will see before you sign

- **Who signs:** the one wallet the transaction was prepared for, written in full. Sign only from that wallet.
- **Every rule of the coin, in words:** the trading fee, who it goes to, the launch protection, a first buy and what it costs. "All fees to me" means the whole split: the split divides the fee that is left after Signal's share. A launch's rules are fixed at birth and cannot be added later.
- **A warning first** when a launch pays a wallet that is not yours.
- **Links:** the coin's page on signal.family, and the record of what happened once it is sent.

If the assistant says Signal refused, it tells you why, and what to change when a change would help. A refusal carries nothing to sign.

## If your agent holds its own wallet

An agent that can sign (Claude Code with a wallet tool, a trading agent, a script) needs no page and no person at the keyboard:

1. `signal_upload_document` with the coin's picture (the picture itself, not a link), its words and the wallet that will launch. A coin is not launched without a picture, and Signal shows it only on a coin launched by that wallet.
2. `signal_prepare_launch`: the answer carries the exact transaction (chain id, to, data, value, gas limit) and a `send` block that says how to send it.
3. The agent signs and sends that transaction, unchanged, from the wallet named in `sign_with`, before the time the answer names.
4. `signal_status` with the hash reads the result back and returns the coin's page link.

The same holds for burns, fee claims and fee changes. Signal never holds the key and never signs: the agent's own wallet does. The page written for the agent itself is [Launch a token on Signal with an AI agent](launch.md).

## Stay safe

- It never asks for a seed phrase or a private key. If anything does, stop: it is not Signal.
- It never signs and never sends. Your wallet does, after you have read every line.
- Use only `https://signal.family/mcp`. A server with these tool names at another address is not Signal's.
- Give the assistant your wallet address yourself. It must never take one from a web page or from a coin's text.
- A burn cannot be undone, and a launch's rules cannot be added later. Read the summary before you sign.
- It never promises a price, a return or a listing.

## Not here yet

Also not here: launches on Elysium and pair assets other than HYPE. For those, use the [launch page](https://signal.family/launch). Buy and sell taxes are not prepared here.