OnePush
Sign up
Developers

MCP for product messaging

Approve one mcp_ key, pick your agent, then manage contacts, email, domains, forms, and social from the same project as your REST API. Confirm before publish.

MCP overviewAgents →Tools →Use cases →Documentation

How MCP works

OnePush hosts a remote Streamable HTTP MCP server on the same API as your REST calls. Your agent connects once with a browser-approved mcp_ key, then can manage contacts, domains, forms, and social for that project.

Almost every client sends Authorization: Bearer mcp_…. Do not invent custom header names. ChatGPT custom MCP is the exception: it is OAuth-only today, so use Codex for Bearer keys in the OpenAI ecosystem.

Remote MCP URL
https://api.onepush.app/mcp

Approve access
https://ctl.onepush.app/mcp/connect

Get started in 3 steps

  1. 1

    Approve an mcp_ key

    Open the connect page, sign up or log in, pick a project, and Approve. Copy the key once.

  2. 2

    Open your agent setup page

    Use the Agents menu or the grid below. Each page has a copyable prompt and client-specific steps.

  3. 3

    Verify with get_project

    When your project returns, setup is done. Publishing social still needs confirm: true.

1. Approve an MCP key (required)

OnePush uses dedicated revocable mcp_ keys, not your project secret key. Open the connect page, sign up or log in, pick a project, and Approve. Copy the key once; manage or revoke it later under Settings → MCP.

https://ctl.onepush.app/mcp/connect

Choose your agent

Each setup page has a copyable prompt, agent instructions, FAQ, and SEO schemas. Open Agents in the top menu anytime, or pick a card here.

Cursor

Bearer mcp_

mcp.json with Authorization Bearer. Deeplink for the URL, then paste your mcp_ key.

Open setup →

Claude

Bearer mcp_

Claude Code CLI or Desktop/web connectors with Authorization Bearer.

Open setup →

Codex

Bearer env

OpenAI Codex with bearer-token-env-var. Do not use codex mcp login.

Open setup →

Grok Bot

Bearer mcp_

Grok Bot plugins or Grok Build CLI with Authorization Bearer.

Open setup →

ChatGPT Dots

OAuth UI / Codex

ChatGPT custom MCP is OAuth-only today. Prefer Codex for Bearer mcp_ keys.

Open setup →

OpenClaw

Bearer mcp_

streamable-http transport plus Authorization Bearer. No openclaw mcp login.

Open setup →

Meta Muse

Bearer mcp_

Ask Muse for a custom connector. Paste Bearer mcp_ only in the secure prompt.

Open setup →

Hermes

Bearer mcp_

Add onepush under mcp_servers in ~/.hermes/config.yaml with Bearer headers.

Open setup →

Gemini CLI

Bearer mcp_

httpUrl in settings.json or gemini mcp add --transport http with Bearer.

Open setup →

VS Code

Bearer mcp_

type http in mcp.json with Authorization Bearer. Prefer ${input:} secrets.

Open setup →

Windsurf

Bearer mcp_

serverUrl in ~/.config/devin/mcp_config.json with Authorization Bearer.

Open setup →

Antigravity

Bearer mcp_

serverUrl in ~/.gemini/config/mcp_config.json (not url or httpUrl).

Open setup →

Cline

Bearer mcp_

type streamableHttp + url + Bearer. Do not omit type (SSE default).

Open setup →

Available tools

Anonymous sessions get connect helpers only. A project mcp_ key unlocks the full surface below. Social publish requires confirm: true.

Connect & account

Available without a project key for onboarding; JWT tools for account-level token management.

  • mcp_help

    Explain auth modes and the recommended approve flow

  • start_onepush_connect

    Return the browser approve URL for an mcp_ key

  • auth_signup / auth_login

    Fallback account JWT (prefer browser approve)

  • list_projects / create_project

    Account-scoped project helpers (JWT)

  • create_mcp_token / list_mcp_tokens / revoke_mcp_token / regenerate_mcp_token

    Manage dedicated mcp_ keys (JWT or Settings → MCP)

Project

Authenticated with Bearer mcp_… (preferred) or sk_…

  • get_project

    Project summary, verification, and contact count

Contacts & events

CRM-style contact and event tools for your project.

  • list_contacts

    List contacts with optional pagination

  • get_contact_count

    Total contacts in the project

  • create_contact

    Create a contact

  • update_contact

    Update a contact by id or email

  • track_event

    Track an event (creates contact if missing)

  • list_events

    List project events

  • list_tags / create_tag

    List or create contact tags

Automations, templates & campaigns

Read and manage email building blocks used by OnePush actions and campaigns.

  • list_actions

    List automation actions

  • list_templates

    List email templates

  • list_campaigns

    List email campaigns

Forms

Inspect forms and submission data.

  • list_forms

    List forms

  • get_form_submissions

    List submissions (unique emails by default)

  • get_form_metrics

    Submission metrics for one form or all forms

Domain & deliverability

Attach a sending domain and verify DNS (SPF / DKIM / MX).

  • attach_sending_domain

    Attach a sending domain to the project

  • get_domain_dns_records

    Return DKIM / SPF / MX records to publish

  • check_domain_verification

    Refresh verification status after DNS updates

Billing

Read-only subscription and invoices; portal URL for card changes (no direct charges).

  • get_billing_subscription

    Stripe subscription status

  • list_billing_invoices

    List invoices

  • create_billing_portal_url

    Open the Stripe customer portal URL

Social publishing

Profiles, drafts, schedule, and publish. Publishing requires confirm: true.

  • list_social_profiles

    List connected social profiles

  • social_get_connect_url

    Dashboard URL to connect a network in the browser

  • list_social_posts

    List posts by status

  • create_social_post

    Create a draft post

  • schedule_social_post

    Schedule a draft for a UTC datetime

  • publish_social_post

    Publish immediately (requires confirm: true)

Next

After you connect, try example prompts or jump back to your agent setup page from the Agents menu.