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
Your step-by-step guide to getting started with Signal
Pitch Radar
Set up AI-matched journalist opportunities with Fit Score
Podcast Discovery
Find podcasts that discussed your exact topic at the episode level
Publication Placement
Strategic publication targeting with Placement Score intelligence
Newsjacking Agent
Real-time breaking news analysis with auto-generated pitch angles
Set up your outreach pipeline
Connect Instantly, Smartlead, Apollo, or custom webhooks
Security & data model
Read our approach to encryption, data isolation, and privacy
Quickstart
Get Signal running in under 5 minutes. You'll scan your first journalist opportunities and generate your first AI pitch draft.
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.
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.
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.
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_journalistsFind journalists by topic, beat, outlet, or location
draft_pitchGenerate AI pitch hooks for a specific journalist
sync_to_attioPush journalist data to Attio CRM with tags
get_journalist_profileRetrieve a full journalist profile with coverage
view_morning_briefToday's matches across all active topic trackers
save_to_listOrganize journalists into media lists
Claude Desktop Setup
Add Signal to your Claude Desktop config to enable all 6 tools:
// ~/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
"What's in my morning brief today?"
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
"Find journalists covering AI ethics and draft a professional pitch about our responsible AI framework"
Claude chains search_journalists → draft_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
"Add Sarah to my AI reporters list and sync to Attio"
Claude chains save_to_list → sync_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.
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.
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.
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.
# 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.Deploy to Your Outreach Tool
Click Deploy Protocol to open the deployment wizard:
- Select Muscle — Pick your connected outreach tool (Instantly, Smartlead, or Apollo)
- Select Campaign — Choose which campaign to add the lead to
- Preview — Verify the pitch variables and toggle Draft vs. Active mode
- Dedup Check — Signal checks if you've pitched this journalist in the last 30 days
- 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.
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.