# @askaudience/mcp-server

Ask 10,000+ synthetic European personas grounded in real survey data (ESS & WVS). Create target audiences, run surveys, compare segments, and interview individual AI twins — all via MCP tools for Cla…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add askaudience/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list askaudience/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get askaudience/mcp-server audiences.create

# Call a tool
npx -y @smithery/cli@latest tool call askaudience/mcp-server audiences.create '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-askaudience.run.tools`

**Optional config:**
- `apiKey` (query) — Your API key (format: aa_...). Get a free key (50 credits) at https://www.askaudience.de/console/keys

## Tools (7)

- `audiences.create` — Create a new synthetic target audience composed of AI twins grounded in real European survey respondents (ESS & WVS). R…
- `audiences.ask` — Ask a question to a target audience and receive aggregated responses from synthetic twins. Returns individual answers, …
- `audiences.compare` — Ask the same question to multiple target audiences and compare responses side-by-side. Ideal for A/B testing messaging,…
- `audiences.export` — Export audience demographic data as JSON or CSV. Returns safe demographics only (no internal AI persona data). Useful f…
- `digital_humans.search` — Search for individual synthetic personas (AI twins) by free-text query and optional demographic filters. Returns name, …
- `digital_humans.ask` — Ask a single synthetic persona (AI twin) a question and get a grounded response that reflects their demographics, value…
- `usage.get` — Check current credit usage, remaining credits, plan limits, and API request statistics. Use this to monitor consumption…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get askaudience/mcp-server <tool-name>
```

## Prompts (3)

- `market_research` (product, target) — Run a quick market research study on a product idea
- `pricing_test` (product, prices) — Test pricing acceptance across different audience segments
- `message_ab_test` (messageA, messageB, audience) — A/B test marketing messages with synthetic audiences