Signal Relay

You can deploy and use the Signal Relay MCP Server to connect AI agents to SocioLogic’s synthetic persona platform, enabling interviews, campaigns, focus groups, and data exports through a standard MCP workflow with secure, edge-enabled performance.

How to use

You use an MCP client to connect to the Signal Relay MCP Server. Start by obtaining an API key, then configure your MCP client to point at the server’s URL and include your API key in requests. Once configured, you can list personas, create and run campaigns, interview personas, retrieve semantic memories, and export results. Interact through your MCP client just as you would with any MCP provider: call tools, pass parameters, and handle responses from the SocioLogic API via the Cloudflare edge server.

How to install

Prerequisites you need before installation:

Step-by-step installation for self-hosting the MCP server on Cloudflare Workers:

# 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 to Cloudflare Workers
npx wrangler deploy

Configuration

Configure the MCP client to connect to the hosted server or your self-hosted endpoint. If you are using the hosted server, you will use the public URL and supply your API key in requests. If you are hosting yourself, ensure your deployment exposes an MCP URL and that your client passes the API key in the X-API-Key header or Authorization header.

Security

Security considerations for using the Signal Relay MCP Server include using API keys with proper scope, validating inputs, and ensuring no data is stored on the edge. Each request should include an API key in the X-API-Key header or an Authorization: Bearer header, and requests should be validated to prevent malformed inputs.

Notes

The server supports a variety of tools for managing personas, campaigns, focus groups, and web research. Access is controlled through the API key, and you can export campaign results as PDF or JSON for board-ready reporting.

Available tools

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_interview_persona

Conduct adversarial interview with a persona

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_scrape_url

Scrape content from a URL (web research)

sociologic_search_web

Search the web and scrape results

sociologic_research_topic

Research a topic with multiple sources

sociologic_get_company_info

Get company information from a website