Is Signal Relay safe to install?

SaferSkills independently audited Signal Relay (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

README.md · 1 file

README.md7.5 KB · Markdown

Signal Relay - SocioLogic MCP Server

A remote MCP (Model Context Protocol) server that connects AI agents to SocioLogic's synthetic persona platform. Interview realistic customer personas, run multi-persona research campaigns, and export board-ready reports—all through natural conversation.

Features

24 MCP Tools - Personas, campaigns, focus groups, web research, RNG, credits, and payments
High-Fidelity Personas - Synthetic personas with consistent demographics, psychographics, and behavior
Semantic Memory - RAG-powered memory retrieval for persona continuity across conversations
Edge Deployed - Runs on Cloudflare Workers (300+ locations, <50ms latency)
Secure - API key authentication, request validation, no data stored on edge

Quick Start

Use the Hosted Server (Recommended)

The fastest way to get started is using our hosted server at https://mcp.sociologic.ai.

Get an API key at sociologic.ai/dashboard/api-keys (100 free credits on signup)

Configure your MCP client:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "sociologic": {
      "transport": "http",
      "url": "https://mcp.sociologic.ai",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code (.mcp.json in your project):

{
  "mcpServers": {
    "sociologic": {
      "transport": "http",
      "url": "https://mcp.sociologic.ai",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Start chatting! Ask Claude to interview personas, create campaigns, or explore the marketplace.

Self-Hosting

Deploy your own instance to Cloudflare Workers:

Prerequisites

Node.js v18+
Cloudflare account (free tier works)

Installation

# Clone the repository
git clone https://github.com/SocioLogicAI/signal-relay.git
cd signal-relay

# Install dependencies
npm install

# Login to Cloudflare
npx wrangler login

# Deploy
npx wrangler deploy

Your server will be available at https://sociologic-mcp-server.<your-subdomain>.workers.dev

Local Development

npm run dev

Starts a local server at http://localhost:8787.

Available Tools

Tool	Description
`sociologic_list_personas`	List synthetic personas from marketplace or private collection
`sociologic_get_persona`	Get detailed persona information (demographics, psychographics, traits)
`sociologic_create_persona`	Generate a new persona from natural language description
`sociologic_get_persona_memories`	Retrieve persona's semantic memories via vector search
`sociologic_list_campaigns`	List research campaigns with status and results
`sociologic_get_campaign`	Get campaign details including interviews and findings
`sociologic_create_campaign`	Create multi-persona research campaign with custom questions
`sociologic_execute_campaign`	Execute draft campaign (async background processing)
`sociologic_export_campaign`	Export campaign results as PDF or JSON
`sociologic_list_focus_groups`	List focus groups for cohort-based research
`sociologic_get_focus_group`	Get focus group details with member personas
`sociologic_create_focus_group`	Create new focus group to organize personas
`sociologic_add_personas_to_focus_group`	Add personas to an existing focus group
`sociologic_get_credits_balance`	Check current credits balance and usage
`sociologic_search_web`	Search the web and scrape results
`sociologic_research_topic`	Research a topic with multiple sources

API Endpoints

Endpoint	Method	Description
`/`	POST	JSON-RPC 2.0 endpoint for MCP protocol
`/health`	GET	Health check (requires API key)
`/info`	GET	Server information and available tools

Example Usage

List Available Personas

curl -X POST https://mcp.sociologic.ai/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "sociologic_list_personas",
      "arguments": {
        "visibility": "public",
        "per_page": 10
      }
    }
  }'

Configuration

Environment Variables

Variable	Description	Default
`SOCIOLOGIC_API_URL`	Backend API URL	`https://www.sociologic.ai`

wrangler.toml

[vars]
SOCIOLOGIC_API_URL = "https://www.sociologic.ai"

Security

API keys are passed via X-API-Key header or Authorization: Bearer header
Request size limited to 1MB to prevent DoS
Input validation via Zod schemas on all tool parameters
No data stored on edge - all data flows through to the SocioLogic API

Rate Limiting

For production deployments, we recommend enabling Cloudflare's rate limiting:

Go to Cloudflare Dashboard > Security > WAF > Rate limiting rules
Create a rule: 100 requests per 10 seconds per IP

Architecture

┌─────────────────┐      ┌─────────────────────┐      ┌─────────────────┐
│                 │      │                     │      │                 │
│   MCP Client    │─────▶│  Cloudflare Worker  │─────▶│  SocioLogic API │
│  (Claude, etc)  │      │   (This Server)     │      │                 │
│                 │◀─────│                     │◀─────│                 │
└─────────────────┘      └─────────────────────┘      └─────────────────┘
        │                         │                          │
        │    MCP Protocol         │    REST API              │
        │    (JSON-RPC 2.0)       │    (HTTPS)               │
        └─────────────────────────┴──────────────────────────┘

Pricing

Operation	Credits
List personas	1
Get persona	1
Create persona	5-50 (by fidelity tier)
Interview persona	1 per message
Campaign execution	Varies by size

Free tier: 100 credits on signup. See sociologic.ai/pricing for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Signal Relay— agent skill

Is Signal Relay safe to install?

Signal Relay - SocioLogic MCP Server

Features

Quick Start

Use the Hosted Server (Recommended)

Self-Hosting

Prerequisites

Installation

Local Development

Available Tools

API Endpoints

Example Usage

List Available Personas

Configuration

Environment Variables

wrangler.toml

Security

Rate Limiting

Architecture

Pricing

Contributing

License

Links

Audit the pieces. Scan the whole. Decide.