Signal Relay

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.

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

1. 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" } } } }

1. 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. .workers.dev

Local Development

npm run dev

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

Available Tools

API Endpoints

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

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:

1. Go to Cloudflare Dashboard > Security > WAF > Rate limiting rules
2. 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

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

Contributing

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

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

License

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

Links

• SocioLogic Website
• API Documentation
• MCP Protocol Specification
• Cloudflare Workers Docs