@askaudience/claude-plugin

Claude Code plugin for AskAudience — query AI personas built from real European (DACH) survey data.

Ask questions, compare audiences, and explore synthetic survey respondents — without recruiting a single participant.

Installation

/plugin install github:askaudience/claude-plugin

Or install from npm:

/plugin install @askaudience/claude-plugin

Setup

After installing, configure your API key:

/askaudience:setup

Get an API key at askaudience.de. Keys start with aa_.

Set the environment variable in your shell profile:

export ASKAUDIENCE_API_KEY="aa_your_key_here"

Slash Commands

| Command | Description | |---|---| | /askaudience:setup | Configure your API key | | /askaudience:ask | Ask an audience a question | | /askaudience:create | Create a new synthetic audience | | /askaudience:compare | Compare audiences on the same question | | /askaudience:search | Search for individual personas | | /askaudience:usage | Check credit balance and usage |

Usage Examples

Ask your audience a question

/askaudience:ask aud_abc123 "Would you switch to a plant-based diet?"

Create an audience and ask a question

/askaudience:create "Munich Millennials" age 25-35 DE Munich

Then ask:

/askaudience:ask aud_newid "What's your biggest financial worry right now?"

Compare two audiences

/askaudience:compare aud_berlin aud_munich "How important is work-life balance?"

Find specific personas

/askaudience:search "environmentally conscious parents in Hamburg"

Check your credits

/askaudience:usage

MCP Tools

This plugin wraps @askaudience/mcp-server and exposes 7 MCP tools:

| Tool | Description | |---|---| | askaudience_create_audience | Create a filtered synthetic audience | | askaudience_ask_audience | Ask a question to an audience | | askaudience_compare_audiences | Compare audiences on the same question | | askaudience_export_audience | Export audience data as JSON/CSV | | askaudience_search_digital_humans | Search for individual personas | | askaudience_ask_digital_human | Ask a single persona a question | | askaudience_get_usage | Check credits and usage stats (free) |

Development

# Install dependencies
npm install

# Run tests
npm test

# Type check
npm run typecheck

# Lint
npm run lint

# Build
npm run build

License

MIT — AskAudience GmbH