English Français العربية

io.github.SocioLogicAI/signal-relay

Registre officiel Recherche et web

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

Code source Documentation

Que pouvez-vous faire avec io.github.SocioLogicAI/signal-relay ?

  • 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http signal-relay 'https://mcp.sociologic.ai' --header 'X-API-Key: <Your SocioLogic API key>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "signal-relay": {
            "type": "http",
            "url": "https://mcp.sociologic.ai",
            "headers": {
                "X-API-Key": "<Your SocioLogic API key>"
            }
        }
    }
}
NPM package signal-relay-mcp
Claude Code 
claude mcp add signal-relay -- npx -y signal-relay-mcp@2.0.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "signal-relay": {
            "command": "npx",
            "args": [
                "-y",
                "signal-relay-mcp@2.0.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Signal Relay - SocioLogic MCP Server
  2. Features
  3. Quick Start
  4. Self-Hosting
  5. Available Tools
  6. API Endpoints
  7. Example Usage
  8. Configuration
  9. Security
  10. Architecture
  11. Pricing
  12. Contributing
  13. License
  14. Links

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

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

{
  "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
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.<your-subdomain>.workers.dev

Local Development
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
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
[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.

Questions fréquentes

Qu'est-ce que io.github.SocioLogicAI/signal-relay ?

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

Comment installer io.github.SocioLogicAI/signal-relay ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http signal-relay 'https://mcp.sociologic.ai' --header 'X-API-Key: <Your SocioLogic API key>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.SocioLogicAI/signal-relay ?

Oui. Il attend X-API-Key, à renseigner dans sa configuration.

io.github.SocioLogicAI/signal-relay est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.SocioLogicAI/signal-relay ?

Il est publié par SocioLogicAI. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.