@signaliz/mcp-server

Public stdio MCP package for Signaliz.

Use this package when Claude Code, Codex, Cursor, or another local MCP client needs Signaliz as its GTM execution layer. The server proxies to the hosted Signaliz MCP endpoint and exposes a curated default shelf for workspace, enrichment, Ops, and campaign-building workflows.

Quick Start

1. Get your API key at app.signaliz.com/settings/api-keys
2. Add to your MCP client:

claude mcp add signaliz -e SIGNALIZ_API_KEY=sk_your_key -- npx -y @signaliz/mcp-server

By default the server talks to https://api.signaliz.com/functions/v1.

What this package is

This package is the public local stdio distribution intended for Codex, Claude Code, Cursor, and other MCP clients that launch a local command like:

npx -y @signaliz/mcp-server

It is not the same surface as the broader hosted remote MCP used for browser/OAuth flows.

Tool coverage

The public stdio package defaults to the same curated tool shelf as the hosted Signaliz MCP endpoint:

• get_workspace
• get_tool_manifest
• discover_capabilities
• signaliz_execute_tool
• check_job_status
• find_people_signaliz
• find_companies_signaliz
• generate_leads
• find_and_verify_emails
• verify_emails
• enrich_company_signals
• custom_ai_prompt
• ops_plan
• ops_execute
• ops_status
• ops_wait
• ops_results
• ops_approve
• nango_integration_flow_prepare
• nango_connect_session_create
• nango_mcp_tools_list
• nango_mcp_read_write_audit
• nango_mcp_tool_call_and_wait
• nango_mcp_action_result_get
• build_campaign
• get_campaign_build_status
• get_campaign_build_rows
• gtm_existing_campaign_audit
• gtm_campaign_execution_status
• gtm_campaign_learning_status

Advanced, compatibility, workspace, and legacy tools remain callable through direct hosted tools/call, get_tool_manifest({ include_hidden: true }), discover_capabilities, and signaliz_execute_tool.

Set SIGNALIZ_MCP_PROFILE=full to expose the legacy exhaustive stdio bridge as top-level tools.

Builder includes unlimited cache search, Campaign Builder, API, MCP, CLI, Ops, and integrations. Team is the $499/month public plan and adds unlimited live Find People and Find Companies in Signaliz; Agency stays $999/month with higher credits and throughput. Fresh credits are used only when Signaliz creates, verifies, or fetches new premium data. Live email verification is 0.02 fresh enrichment credits when a new verification is needed; available or fresh-enough verification results return for 0 credits. Current fresh enrichment ceilings are Free 60/min, Builder 300/min, Team 600/min, Agency 1,000/min, and Pay-As-You-Go 1,000/min, plus a 5,000/hour workspace safety cap.

For exact regression checks, run npm run test:campaign-tools in this package. It builds the stdio server and verifies the Campaign Builder tools through tools/list.

How it works

Most heavy operations are async:

1. Submit work and get a job_id
2. Poll check_job_status
3. Read results when the job finishes

This keeps the local MCP transport stable even for large runs.

Configuration

| Variable | Required | Description | |----------|----------|-------------| | SIGNALIZ_API_KEY | Yes | Your API key (sk_...) | | SIGNALIZ_API_URL | No | Custom functions base URL, for example https://api.signaliz.com/functions/v1 | | SIGNALIZ_MCP_PROFILE | No | Use full to expose the legacy exhaustive top-level tool list. Defaults to the curated shelf. |

Uninstall

claude mcp remove signaliz