Signal Documentation

Everything you need to set up PR intelligence, integrate your outreach tools, and build on the Signal API. From quickstart to advanced configuration.

Guides

Quickstart

Get Signal running in under 5 minutes. You'll scan your first journalist opportunities and generate your first AI pitch draft.

1

Create your account

Sign up at signalpr.pro/login with your Google account. No credit card required — you get a 14-day free trial of the Launch plan.

2

Scan your website

During onboarding, paste your company URL. Signal's AI crawls your site and extracts 5 expertise vectors — these are the core competencies Signal uses to match you with relevant journalists.

3

Explore your first matches

Navigate to Pitch Radar to see AI-matched journalist opportunities ranked by Fit Score. Each opportunity comes with an auto-generated pitch draft you can edit and send.

4

Connect your outreach tools

Go to Settings → Infrastructure Hub to connect your Instantly, Smartlead, or Apollo accounts. This enables the Deploy Protocol — push matched journalists directly into your outreach campaigns.

Core Concepts

48-Hour Refresh Cycle

How Signal keeps journalist data fresh

Signal refreshes its journalist and publication data every 48 hours. This means every journalist's recent articles, beats, and coverage patterns are re-analyzed twice a week. Unlike databases that update monthly or quarterly, Signal's data reflects what journalists are covering right now.

Fit Score Algorithm

1024-dimensional vector matching

Fit Score is Signal's proprietary match quality metric. It uses 1024-dimensional embedding vectors (via Amazon Titan Embed v2) to measure the cosine similarity between your expertise vectors and a journalist's recent coverage.

A Fit Score of 90%+ means the journalist has recently covered topics deeply aligned with your expertise. Signal recommends pitching journalists with a Fit Score above 85%.

Knowledge Base

Your company's PR context

The Knowledge Base stores your company's expertise context — press kits, product descriptions, key metrics, and talking points. This context powers AI pitch generation: when Signal drafts a pitch, it references your Knowledge Base to write pitches that sound like you, not generic templates.

MCP Integration

Model Context Protocol — AI-native PR workflows

What is MCP?

Model Context Protocol (MCP) is an open protocol that lets AI assistants like Claude Desktop call external tools directly — think of it as "USB for AI". Signal's MCP bridge exposes 6 PR intelligence tools that Claude can call in natural conversation, enabling workflows like:

"Find journalists who cover AI funding and draft a pitch for each"

"Check this morning's brief and sync the top matches to Attio"

"Add Sarah Chen to my AI reporters list with a note about her article"

Architecture

The MCP bridge is a lightweight Node.js proxy that translates MCP tool calls into Signal Core API requests:

Claude Desktop

AI Assistant

MCP Bridge

Express + MCP SDK

Core API

FastAPI + Bedrock

PostgreSQL

pgvector

6 Available Tools

Every tool returns structured data with dashboard deep links and attribution.

search_journalists

Find journalists by topic, beat, outlet, or location

draft_pitch

Generate AI pitch hooks for a specific journalist

sync_to_attio

Push journalist data to Attio CRM with tags

get_journalist_profile

Retrieve a full journalist profile with coverage

view_morning_brief

Today's matches across all active topic trackers

save_to_list

Organize journalists into media lists

Claude Desktop Setup

Add Signal to your Claude Desktop config to enable all 6 tools:

json
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "signal": {
      "url": "https://signal-mcp-bridge-562129764887.us-central1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SIGNAL_API_KEY"
      }
    }
  }
}

Find your API key in Settings → API & MCP in the Signal dashboard. After saving, restart Claude Desktop — you'll see "Signal" listed in the MCP tools panel.

Example Conversations

Morning Workflow

U

"What's in my morning brief today?"

C

Claude calls view_morning_brief

Your morning brief has 3 matches:

  • OpenAI Closes $10B Round — relevance: 92%
  • Google Launches New AI Chip — relevance: 88%
  • EU AI Act Update — relevance: 85%

Would you like me to draft pitches for any of these?

Find & Pitch Workflow

U

"Find journalists covering AI ethics and draft a professional pitch about our responsible AI framework"

C

Claude chains search_journalistsdraft_pitch

Found 8 journalists covering AI ethics. Here's the top match:

Sarah Chen — TechCrunch, AI & ML beat

"Given your recent investigation into AI bias in hiring tools, our new Responsible AI Framework addresses exactly the concerns you raised..."

Shall I sync Sarah to Attio CRM or save her to a media list?

Organize & Sync

U

"Add Sarah to my AI reporters list and sync to Attio"

C

Claude chains save_to_listsync_to_attio

Done! Sarah Chen has been:

✅ Added to "AI Beat Reporters" list

✅ Synced to Attio CRM for pipeline tracking

Why MCP changes everything

Natural Language

No dashboards to learn. Just tell Claude what you need in plain English.

Tool Chaining

Claude composes multi-step workflows automatically: search → pitch → sync → organize.

Always Available

Works inside your existing Claude conversation — no app switching, no context loss.

Tutorial: Find, Pitch, Deploy

A complete walkthrough from first scan to deployed outreach

This tutorial walks you through Signal's complete PR intelligence cycle. You'll discover a relevant journalist, get an AI-drafted pitch, and deploy it to your outreach infrastructure — all in under 10 minutes.

1

Set Up Your Knowledge Base

Navigate to Settings → Knowledge Base and paste your company URL. Signal's AI crawls your website and extracts 5 expertise vectors.

💡 Pro Tip

Edit the vectors after extraction. The more specific they are (e.g., "AI-powered cost optimization for enterprise SaaS" vs. "technology"), the better your Fit Scores will be.

2

Discover Journalist Matches

Open Pitch Radar from the sidebar. Signal has already scanned journalist requests and ranked them by Fit Score against your expertise vectors.

Click on any opportunity to see the journalist's recent coverage, their beat, and an auto-generated pitch draft. The Fit Score tells you how well-aligned this journalist is with your expertise — anything above 85% is a strong match.

3

Review & Edit Your Pitch

Every opportunity comes with a pre-generated pitch draft. The AI uses your Knowledge Base context + the journalist's recent coverage to write something specific — not a template.

Edit the pitch inline. Signal writes in "Expert Industrial" voice by default: short, data-backed, zero fluff. Adjust the tone and add your own angle before deploying.

text
# Example auto-generated pitch:

"Given your deep-dive into AI cost optimization last week, 
you'll want to know that our platform just reduced inference 
costs by 40% for 3 Fortune 500 clients — happy to share the 
methodology exclusively before the Q3 earnings cycle."

# No templates. Lead with data. Under 200 words.
4

Deploy to Your Outreach Tool

Click Deploy Protocol to open the deployment wizard:

  1. Select Muscle — Pick your connected outreach tool (Instantly, Smartlead, or Apollo)
  2. Select Campaign — Choose which campaign to add the lead to
  3. Preview — Verify the pitch variables and toggle Draft vs. Active mode
  4. Dedup Check — Signal checks if you've pitched this journalist in the last 30 days
  5. Push — The lead is added to your outreach campaign

⚠ Safety Default

Leads are always added as drafts by default. You can enable "Active" mode (sends immediately) from Settings, but it requires the Pro plan and an explicit opt-in. We protect you from yourself.

5

Track & Iterate

Signal shows a queue status indicator for all deployed pitches. You can see which leads were pushed successfully, which had duplicates, and which failed — all without leaving the Signal dashboard.

As new journalist requests come in (refreshed every 48 hours), Pitch Radar automatically surfaces new opportunities. Set up Topic Trackers in Settings to get morning briefs with the most relevant matches.

Security Model

Signal is built on a zero-trust architecture with strict multi-tenant data isolation.

🔐 Encryption at Rest

All sensitive data (API keys, CRM tokens) is encrypted using AES-256-GCM with envelope encryption. Data encryption keys (DEKs) are generated per-record and themselves encrypted with AWS KMS customer-managed keys.

🧱 Tenant Isolation

Every database query is scoped by the authenticated user's JWT sub claim. Row-level filtering ensures no user can access another user's journalists, pitches, or integration credentials.

🔒 Non-Custodial Outreach

Signal never stores your email credentials or sends emails directly. We act as the intelligence layer for your existing outreach infrastructure (Instantly, Smartlead, Apollo). Your outreach tools handle all email delivery.

📋 Compliance

SOC 2 preparation in progress. All containers run as non-root with no-new-privileges security context. Dependency scanning via Dependabot. Container image scanning with Trivy.