sociologicai avatar

Signal Relay

sociologicai/signal-relay

Connects Claude to SocioLogic's synthetic persona platform for conversational market research. Exposes 24 tools covering persona management (list, create, retrieve memories), campaign orchestration (create multi-persona studies, execute interviews, export reports), focus groups, and web research. Runs on Cloudflare Workers at mcp.sociologic.ai with sub-50ms latency. Authentication via API key in headers, 100 free credits on signup. Reach for this when you need to interview realistic customer personas with consistent demographics and RAG-backed memory, run cohort studies, or generate board-ready research reports without leaving your AI workflow. Credit-based pricing scales with persona fidelity and campaign size.

tools
24
auth
Secret needed
transport
HTTP
last updated
May 17, 2026

Tools

24 tools

Public tool metadata for what this MCP can expose to an agent.

sociologic_list_personas[Research/Personas] List available synthetic personas from the SocioLogic marketplace or your private collection. Use this to discover personas for interviews or campaigns.5 params

[Research/Personas] List available synthetic personas from the SocioLogic marketplace or your private collection. Use this to discover personas for interviews or campaigns.

Parameters* required
categorystring
Filter by category
pageinteger
Page number for paginationdefault: 1
per_pageinteger
Results per page (max 100)default: 20
searchstring
Search in name, tagline, description
visibilitystring
Filter by visibility: 'public' (marketplace), 'private' (user's own), 'all' (both)one of public · private · alldefault: public
sociologic_get_persona[Research/Personas] Get detailed information about a specific persona including demographics, psychographics, and behavioral traits.1 params

[Research/Personas] Get detailed information about a specific persona including demographics, psychographics, and behavioral traits.

Parameters* required
slugstring
The persona's unique slug identifier
sociologic_create_persona[Research/Personas] Create a new AI persona from a natural language description. Returns rich persona data including demographics, psychographics, communication style, and behavioral traits. Use the returned data to role-play as this persona in conversation, or pass it to a su...3 params

[Research/Personas] Create a new AI persona from a natural language description. Returns rich persona data including demographics, psychographics, communication style, and behavioral traits. Use the returned data to role-play as this persona in conversation, or pass it to a su...

Parameters* required
descriptionstring
Natural language description of the persona to create
include_avatarboolean
Whether to generate a profile picture. Defaults to false. Adds 0.75 credits to the cost.default: false
x402_paymentobject
Optional x402 crypto payment to use instead of credits
sociologic_get_persona_memories[Research/Personas] Retrieve a persona's semantic memories. Memories are vector-embedded learnings from past interactions that inform future responses.3 params

[Research/Personas] Retrieve a persona's semantic memories. Memories are vector-embedded learnings from past interactions that inform future responses.

Parameters* required
limitinteger
Maximum number of memories to returndefault: 10
querystring
Optional semantic search query to filter memories
slugstring
The persona's unique slug identifier
sociologic_list_campaigns[Research/Campaigns] List your research campaigns. Campaigns are structured multi-persona interview sessions with defined questions.4 params

[Research/Campaigns] List your research campaigns. Campaigns are structured multi-persona interview sessions with defined questions.

Parameters* required
include_interviewsboolean
Include interview details in responsedefault: false
limitinteger
Maximum number of campaigns to returndefault: 20
offsetinteger
Number of campaigns to skip for paginationdefault: 0
statusstring
Filter by campaign statusone of draft · running · completed · failed
sociologic_get_campaign[Research/Campaigns] Get detailed information about a specific campaign including status, personas, questions, and interview results.1 params

[Research/Campaigns] Get detailed information about a specific campaign including status, personas, questions, and interview results.

Parameters* required
idstring
The campaign's unique ID
sociologic_create_campaign[Research/Campaigns] Create a new research campaign. Define questions and either generate new personas or use existing ones. Campaigns enable systematic multi-persona research.8 params

[Research/Campaigns] Create a new research campaign. Define questions and either generate new personas or use existing ones. Campaigns enable systematic multi-persona research.

Parameters* required
descriptionstring
Description of the campaign's purpose
existing_persona_idsarray
Use existing personas instead of generating new ones
focus_group_idsarray
Use personas from existing focus groups
namestring
Name for the campaign
persona_briefstring
Description for generating new personas (if not using existing)
persona_countinteger
Number of personas to generate (if using persona_brief)default: 10
questionsarray
Research questions to ask personas
research_contextobject
Research context for AI-guided questioning
sociologic_execute_campaign[Research/Campaigns] Execute a draft campaign. This triggers background interviews with all personas and generates a research report. Long-running operation.1 params

[Research/Campaigns] Execute a draft campaign. This triggers background interviews with all personas and generates a research report. Long-running operation.

Parameters* required
idstring
The campaign's unique ID to execute
sociologic_export_campaign[Research/Campaigns] Export a completed campaign's results as PDF or JSON. PDF includes executive summary, persona responses, and synthesized findings.2 params

[Research/Campaigns] Export a completed campaign's results as PDF or JSON. PDF includes executive summary, persona responses, and synthesized findings.

Parameters* required
formatstring
Export formatone of pdf · jsondefault: pdf
idstring
The campaign's unique ID
sociologic_list_focus_groups[Research/Focus Groups] List your focus groups. Focus groups are collections of personas for cohort-based research.2 params

[Research/Focus Groups] List your focus groups. Focus groups are collections of personas for cohort-based research.

Parameters* required
limitinteger
Maximum number of focus groups to returndefault: 20
offsetinteger
Number of focus groups to skip for paginationdefault: 0
sociologic_get_focus_group[Research/Focus Groups] Get detailed information about a focus group including its member personas.1 params

[Research/Focus Groups] Get detailed information about a focus group including its member personas.

Parameters* required
idstring
The focus group's unique ID
sociologic_create_focus_group[Research/Focus Groups] Create a new focus group to organize personas for cohort-based research.2 params

[Research/Focus Groups] Create a new focus group to organize personas for cohort-based research.

Parameters* required
descriptionstring
Description of the focus group's purpose
namestring
Name for the focus group
sociologic_add_personas_to_focus_group[Research/Focus Groups] Add one or more personas to an existing focus group.2 params

[Research/Focus Groups] Add one or more personas to an existing focus group.

Parameters* required
focus_group_idstring
The focus group's unique ID
persona_idsarray
Array of persona IDs to add to the focus group
sociologic_get_credits_balance[Payments] Check your current credits balance. Credits are used for persona interviews and campaign execution.

[Payments] Check your current credits balance. Credits are used for persona interviews and campaign execution.

No parameter schema in public metadata yet.

sociologic_get_x402_discovery[Payments] Get x402 payment discovery information. Returns which endpoints accept crypto payments (USDC on Base), wallet address, pricing, and facilitator details.

[Payments] Get x402 payment discovery information. Returns which endpoints accept crypto payments (USDC on Base), wallet address, pricing, and facilitator details.

No parameter schema in public metadata yet.

sociologic_search_web[Search & Scraping] Search the web and return scraped results. Returns markdown content from matching pages.2 params

[Search & Scraping] Search the web and return scraped results. Returns markdown content from matching pages.

Parameters* required
limitinteger
Maximum number of results to returndefault: 5
querystring
Search query
sociologic_research_topic[Search & Scraping] Search a topic and aggregate content from multiple web sources. Returns summarized results useful for building research context.2 params

[Search & Scraping] Search a topic and aggregate content from multiple web sources. Returns summarized results useful for building research context.

Parameters* required
source_countinteger
Number of sources to gatherdefault: 3
topicstring
Topic to research for persona enrichment
sociologic_rng_uuid[Utilities] Generate a cryptographically random UUID v4. Useful for creating unique identifiers for experiments, sessions, or tracking.

[Utilities] Generate a cryptographically random UUID v4. Useful for creating unique identifiers for experiments, sessions, or tracking.

No parameter schema in public metadata yet.

sociologic_rng_random[Utilities] Generate a cryptographically random floating-point number between 0 and 1. Uses hardware entropy for true randomness. Returns a float. Use sociologic_rng_int for integers in a specific range.

[Utilities] Generate a cryptographically random floating-point number between 0 and 1. Uses hardware entropy for true randomness. Returns a float. Use sociologic_rng_int for integers in a specific range.

No parameter schema in public metadata yet.

sociologic_rng_int[Utilities] Generate a cryptographically random integer within a range. Default range is 0-100. Uses hardware entropy for true randomness.2 params

[Utilities] Generate a cryptographically random integer within a range. Default range is 0-100. Uses hardware entropy for true randomness.

Parameters* required
maxinteger
Maximum value (inclusive)default: 100
mininteger
Minimum value (inclusive)default: 0
sociologic_rng_dice[Utilities] Roll a cryptographically random die with a configurable number of sides. Default is a 6-sided die. Uses hardware entropy for true randomness.1 params

[Utilities] Roll a cryptographically random die with a configurable number of sides. Default is a 6-sided die. Uses hardware entropy for true randomness.

Parameters* required
sidesinteger
Number of sides on the die (2-1000)default: 6
sociologic_rng_coin[Utilities] Flip a cryptographically random coin. Returns heads or tails. Uses hardware entropy for true randomness.

[Utilities] Flip a cryptographically random coin. Returns heads or tails. Uses hardware entropy for true randomness.

No parameter schema in public metadata yet.

sociologic_rng_shuffle[Utilities] Randomly shuffle an array of items using the Fisher-Yates algorithm with cryptographic randomness. Useful for randomizing survey question order, A/B test assignments, or persona selection.1 params

[Utilities] Randomly shuffle an array of items using the Fisher-Yates algorithm with cryptographic randomness. Useful for randomizing survey question order, A/B test assignments, or persona selection.

Parameters* required
itemsarray
Array of items to shuffle (1-1000 items)
sociologic_rng_weighted[Utilities] Select a random item from an array using weighted probabilities with cryptographic randomness. Useful for simulating demographic distributions, market share splits, or probability-based scenarios.2 params

[Utilities] Select a random item from an array using weighted probabilities with cryptographic randomness. Useful for simulating demographic distributions, market share splits, or probability-based scenarios.

Parameters* required
itemsarray
Array of items to choose from (1-1000 items)
weightsarray
Array of numeric weights corresponding to each item

Sponsors

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.


View the full README on GitHub

Details

Repository
github.com/sociologicai/signal-relay
Package
signal-relay-mcp
Transport
HTTP
Auth
Required
Registry
MCP registry, active