Skip to content

signalsurf-ai/signalsurf

v0.9.3MIT

Access your Signalsurf Workspace context, Projects, CRM, signals, workflows, campaigns, and more from an external AI.

Signalsurf Plugin

The official Signalsurf Plugin connects Claude, Codex, or Cursor to Signalsurf as the authenticated member's chief-of-staff interface, with the same Workspace permissions, Project context, and product tools used in Signalsurf.

The Plugin bundles two things:

  • the hosted Signalsurf MCP connection at https://mcp.signalsurf.ai/mcp;
  • one root operating Skill plus focused Skills for Projects, Records, Sheets, Signals, Listening, Workflows, Content, Conversations, Campaigns, Knowledge, Connections, Onboarding, and custom Skills. They choose work context, resource targets, execution and result persistence independently. A direct File operation can use Project context without a Thread or ownership transfer. Portable references share the maintained core and composed research, lead-sourcing and personal Outbox procedures; live capability schemas supply the callable contract.

Use the HTTPS catalog and ZIP path in Claude Code to avoid its Git-backed marketplace clone. Other apps have their own interface paths; customers should not need to clone this repository. See Getting started for Claude / Cowork, Codex / ChatGPT, Cursor, and Grok Bot, including availability and administrator requirements. Reading a repository URL in chat does not itself install the plugin.

Connect the bundled Signalsurf service after installation if the app lists it as disconnected. OAuth starts during connection or first use. Review the requested grants for current and future accessible Workspaces; the server rechecks current membership and permissions on every call. Tokens are exchanged directly between the host and Signalsurf; do not paste a token into chat or a terminal command.

After installing, start a new chat and ask:

Connect to Signalsurf without changing data. Call get_workspace_context, then find_capabilities, and tell me which Agent, Workspaces, Project collaboration tools, and product tools are available.

For apps supporting custom remote MCP, the connection URL is https://mcp.signalsurf.ai/mcp. It supplies the same tools and permission checks without installing these Skills. Follow the MCP setup guide.

Cursor and Grok Bot review

The package ships both the portable Agent Plugins manifest and a Cursor manifest. Cursor discovers this directory through the repository's marketplace catalog. Both use the root mcp.json, which connects to the existing hosted server over Streamable HTTP. The MCP server is hosted; no local server process or install hook is required. The package includes a Node.js updater for compatible local hosts, with web guidance fallback for managed hosts. It contains no embedded credentials. A Signalsurf account and access to an authorized Workspace are required; provider connections and usage limits follow the member's account.

The intended Grok Bot workflows include prospect research, CRM and List work, and outreach drafting. Sending, publishing, and campaign activation are separate actions; installing this plugin does not authorize them. Follow any server confirmation or approval requirement before executing a change.

For review, first run the read-only prompt above. Then verify Project context and capability discovery without starting a paid search, sending a message, or modifying CRM data. Test writes only in a designated test Workspace with an explicitly authorized operation. Verify confirmation and retry handling as well as the resulting Record or File.

Grok Bot marketplace availability requires separate review and host testing. See Grok Bot setup. Report connection problems without credentials through the repository's issue tracker. See Privacy and Terms for the hosted service.

Writing guidance

The packaged Writing Skill supports standalone writing, review and rewrite as well as Content, Campaigns, Listening and Conversations copy. It selects email outreach, follow-up, conversation reply, LinkedIn post, X post, public reply, DM or connection-note guidance while preserving author voice and Chinese usage. The guidance is authored for SignalSurf.