Signal Relay

io.github.SocioLogicAIPublished by GitHub account SocioLogicAIv2.0.0Updated Nov 2, 2026

Connect AI agents to SocioLogic's synthetic persona platform for market research.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Connects an assistant to SocioLogic's synthetic persona platform so it can interview AI personas, run research campaigns and export reports.

What you can do
  • Browse, inspect and create synthetic personas, and retrieve their semantic memories
  • Create, execute and export multi-persona research campaigns, including PDF or JSON output
  • Organize personas into focus groups and add members to them
  • Search the web and research topics across multiple sources
  • Check credit balance and usage
When to use it
Useful when you want market-research style input from simulated customer personas, or need to run and export multi-persona interview campaigns from a chat client instead of the SocioLogic dashboard.
Requirements
A SocioLogic account and API key, sent in the X-API-Key header (or as a bearer token). The hosted endpoint is the recommended setup; self-hosting needs Node.js 18+ and a Cloudflare account. Credits are consumed per operation.
Before you install
Operations spend credits: listing and getting cost 1, creating a persona 5-50, interviews 1 per message, and campaign execution varies by size, so usage can cost money beyond the free tier. The API key is a secret passed in a header. Creating personas, campaigns and focus groups writes data to your SocioLogic account, and requests are forwarded to the SocioLogic API.

Installation

In SourceWeft

  1. Open Signal Relay in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.SocioLogicAI%2Fsignal-relay/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "signal-relay": {
      "type": "http",
      "url": "https://mcp.sociologic.ai/"
    }
  }
}

README

Signal Relay - SocioLogic MCP Server

[License: MIT] [MCP]

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)

  2. Configure your MCP client:

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

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

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

json
{  "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

Installation

bash
# Clone the repositorygit clone https://github.com/SocioLogicAI/signal-relay.gitcd signal-relay
# Install dependenciesnpm install
# Login to Cloudflarenpx wrangler login
# Deploynpx wrangler deploy

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

Local Development

bash
npm run dev

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

Available Tools

ToolDescription
sociologic_list_personasList synthetic personas from marketplace or private collection
sociologic_get_personaGet detailed persona information (demographics, psychographics, traits)
sociologic_create_personaGenerate a new persona from natural language description
sociologic_get_persona_memoriesRetrieve persona's semantic memories via vector search
sociologic_list_campaignsList research campaigns with status and results
sociologic_get_campaignGet campaign details including interviews and findings
sociologic_create_campaignCreate multi-persona research campaign with custom questions
sociologic_execute_campaignExecute draft campaign (async background processing)
sociologic_export_campaignExport campaign results as PDF or JSON
sociologic_list_focus_groupsList focus groups for cohort-based research
sociologic_get_focus_groupGet focus group details with member personas
sociologic_create_focus_groupCreate new focus group to organize personas
sociologic_add_personas_to_focus_groupAdd personas to an existing focus group
sociologic_get_credits_balanceCheck current credits balance and usage
sociologic_search_webSearch the web and scrape results
sociologic_research_topicResearch a topic with multiple sources

API Endpoints

EndpointMethodDescription
/POSTJSON-RPC 2.0 endpoint for MCP protocol
/healthGETHealth check (requires API key)
/infoGETServer information and available tools

Example Usage

List Available Personas

bash
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

VariableDescriptionDefault
SOCIOLOGIC_API_URLBackend API URLhttps://www.sociologic.ai

wrangler.toml

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

OperationCredits
List personas1
Get persona1
Create persona5-50 (by fidelity tier)
Interview persona1 per message
Campaign executionVaries 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.

  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

Source: README.md at commit 2f21229

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v2.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts