Connect Signado to your AI assistant

Use this guide to connect your existing Signado workspace to Claude Code, Claude, ChatGPT, Codex, or Grok Bot. The connection uses OAuth in your browser and reads the required client details automatically. You do not need an API key, OAuth client ID, or client secret.

Before you start

• You need a Signado account.
• You need access to the workspace you want the assistant to use.
• The remote endpoint is https://mcp.signado.io/mcp.

Claude Code

Run this command:

claude mcp add --transport http signado https://mcp.signado.io/mcp

Then authenticate:

1. In Claude Code, run /mcp.
2. Choose signado.
3. Click Authenticate.
4. Sign in with your Signado account in the browser.
5. Choose the workspace to connect.
6. Approve the connection.

Claude web app

1. Open Settings → Connectors → Add custom connector.
2. Name it Signado, enter https://mcp.signado.io/mcp as the server URL, and keep authentication on Always required.
3. Under OAuth client, keep Use Anthropic's hosted client metadata (Recommended).
4. Under Advanced, keep Streamable HTTP selected.
5. Select Add, then sign in with Signado, choose your workspace, and approve access.

ChatGPT

1. Open Settings → Plugins. If developer mode is off, enable it, then select + → New Plugin.
2. Name it Signado, enter https://mcp.signado.io/mcp as the server URL, and choose OAuth authentication.
3. Open Advanced OAuth settings and keep Client Identifier Metadata Document (CIMD) as the registration method.
4. Create the plugin, select Sign in with Signado, choose your workspace, and approve access.

Codex

Run this command:

codex mcp add signado --url https://mcp.signado.io/mcp
codex mcp login signado

The login command opens a browser approval flow. Sign in with your Signado account, choose the workspace, and approve the connection.

Codex 0.138.0 sends the OAuth resource parameter natively. If your Codex build cannot complete OAuth, add the resource fallback to ~/.codex/config.toml:

[mcp_servers.signado]
url = "https://mcp.signado.io/mcp"
oauth_resource = "https://mcp.signado.io/mcp"

Very old Codex builds may also need this top-level setting:

experimental_use_rmcp_client = true

Grok Bot

Send this message to your bot:

Add a custom MCP server called signado at https://mcp.signado.io/mcp

Then authenticate:

1. Grok Bot adds the connector and shows a connect card. Select Authorize.
2. Sign in with your Signado account in the browser.
3. Choose the workspace to connect.
4. Approve the connection, then return to Grok Bot.

No API key or auth header is needed. Grok Bot confirms when Signado is connected.

Workspace selector

The browser approval flow includes a workspace selector. Choose the workspace you want your assistant to use. MCP can only access that selected workspace, and the same app permissions apply to every tool call.

If you choose the wrong workspace, disconnect signado in the client and run the login flow again.

Verify the connection

After approval, the client should list 17 tools:

• ping
• list_warm_leads
• get_best_of_run
• get_warm_lead_detail
• export_leads
• list_hiring_leads
• add_hiring_lead_person
• preview_source
• add_source
• set_source_schedule
• remove_source
• find_email
• run_source_once
• cancel_source_run
• draft_message
• list_templates
• save_template

The deprecated compatibility aliases qualify and catchup_source remain callable for older clients but are intentionally absent from the tool listing. There are 19 callable tools in total.

Ask the assistant to call ping. A successful reply confirms that OAuth, workspace selection, and the remote endpoint are working.

Discovery sources

Your assistant can add, preview, and run five source types: keyword topics, creator or competitor profiles, Company pages, individual LinkedIn posts, and Hiring sources (a job title and a country). Use a personal linkedin.com/in/... URL for a creator and a linkedin.com/company/... URL for a Company page. Company pages remain a separate source type in Signado and appear as Company Pages in Warm Leads.

For example, ask: "Add https://www.linkedin.com/company/mondaydotcom/ as a Company page source." The assistant shows the plan and waits for confirmation before monitoring starts. For a Hiring source, ask: "Add a Hiring source for SEO Manager in the United Kingdom." You can include a Daily or Custom schedule when adding keyword, creator, Company page, or Hiring sources, or change one later. For example: "Set my competitor scans to weekdays at 8am UK time." The assistant shows the exact schedule and waits for confirmation. A Custom schedule takes effect at its next selected day and time. Switching an active source to Daily makes its next scan due now, covering the last 24 hours (for a Hiring source, the time since its last scan). Saving the schedule a source already has changes nothing. You can also preview a source first or run it once.

Where results appear

• Warm leads appear on /warm-leads.
• Hiring leads appear on the Hiring tab of /warm-leads.
• Found emails write back to the lead rows on /warm-leads.
• AI drafts from draft_message land in Campaigns at /campaigns.
• Discovery source changes appear in Settings under Discovery Sources.
• Credits show in each paid tool response as credits_charged, balance_after, and session_spend_total. Full usage history is in Settings -> Usage.

Nothing important lives only in the chat. If a session ends, saved results remain in the app.

Credit costs

The MCP connection uses the same credit pool and the same rates as the app:

Action	Cost
Read warm leads	0 credits
Export leads	0 credits
List or save templates	0 credits
Preview a source	1 credit
Add or remove a source	0 credits for the action
New warm lead found, enriched, and scored by an active source	5 credits
New Hiring lead found and scored	5 credits
Scheduled scan that brings you nobody	1 credit (Run once and a source's first scan never pay it)
Attach a person to a Hiring lead	0 credits
Optional one-lead re-score through the deprecated qualify alias	1 credit
Find an email	5 credits per contact
Draft an AI message	3 credits per message

A scheduled scan that brings you nobody costs 1 credit, even when your exclusions removed everyone it found. When it brings you people, you pay only for them: 5 credits per new lead, 1 credit per person already in your leads. Run once and a source's first scan never pay a scan fee. A scan that fails on our side, or that you stop while it is still searching, costs nothing.