Signal Relay

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (16)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Signal Relay.

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

Documentation Overview

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):

config.json

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

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

config.json

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

bash

# 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

Terminal

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

Terminal

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

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

Code

┌─────────────────┐      ┌─────────────────────┐      ┌─────────────────┐
│                 │      │                     │      │                 │
│   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.

Links

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads

76M

Package downloads in the last 30 days.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Signal Relay

signal-relay is a hosted MCP server. Add it as a remote server in your client's config: "mcpServers": { "signal-relay": { "url": "https://mcp.sociologic.ai" } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/signal-relay?style=directory)](https://allmcps.com/mcp/signal-relay)

HTML Embed

<a href="https://allmcps.com/mcp/signal-relay"><img src="https://allmcps.com/api/badge/signal-relay?style=directory" alt="Signal Relay on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

10/14 checks healthy over the last 46d

48Quality signal: Fair · 48/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership6/20

Documentation & tools25/30

Adoption & activity5/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

2 high-severity advisories on record for this package. Most advisories affect transitive dependencies and may not be exploitable in this server's actual usage — this is a directional signal, not a security audit.

Critical 1High 1Medium 2Low 0

Scanned 19d ago via OSV.dev · https://mcp.sociologic.ai (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Signal Relay →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Signal Relay

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (16)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Signal Relay.

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

Documentation Overview

Signal Relay - SocioLogic MCP Server

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):

config.json

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

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

config.json

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

bash

# 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

Terminal

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

Terminal

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

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

Code

┌─────────────────┐      ┌─────────────────────┐      ┌─────────────────┐
│                 │      │                     │      │                 │
│   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.

Links

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads

76M

Package downloads in the last 30 days.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Signal Relay

signal-relay is a hosted MCP server. Add it as a remote server in your client's config: "mcpServers": { "signal-relay": { "url": "https://mcp.sociologic.ai" } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/signal-relay?style=directory)](https://allmcps.com/mcp/signal-relay)

HTML Embed

<a href="https://allmcps.com/mcp/signal-relay"><img src="https://allmcps.com/api/badge/signal-relay?style=directory" alt="Signal Relay on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

10/14 checks healthy over the last 46d

48Quality signal: Fair · 48/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership6/20

Documentation & tools25/30

Adoption & activity5/15

Community engagement0/10

Supply-chain signal

Critical 1High 1Medium 2Low 0

Scanned 19d ago via OSV.dev · https://mcp.sociologic.ai (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Signal Relay →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients