{"_id":"@askaudience/mcp-server","_rev":"4-3ae7b614453077c416327228a09e4259","name":"@askaudience/mcp-server","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@askaudience/mcp-server","version":"0.1.0","keywords":["mcp","model-context-protocol","askaudience","market-research","dach","claude","ai-tools"],"author":{"name":"Tommy Orlik","email":"tommy.moennich@gmx.de"},"license":"MIT","_id":"@askaudience/mcp-server@0.1.0","maintainers":[{"name":"digital-human-api","email":"npm@askaudience.de"}],"homepage":"https://www.askaudience.de","bugs":{"url":"https://github.com/t-moennich/digital-humans-api/issues"},"bin":{"askaudience-mcp":"dist/index.js"},"dist":{"shasum":"28df133a37f89a21434e3fc831175088edc2ff17","tarball":"https://registry.npmjs.org/@askaudience/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":14,"integrity":"sha512-xV4puSAL7/DBP4JOWL+PzaQ2MVdQHVeCs5lnrLZdNw9TJsA235DDqUfjkjjO61pNjrKFEfrn/lTgeTqWOIgjtw==","signatures":[{"sig":"MEUCICYt086zNGK4dw//mQJva26gT3yhb+PW8ZefNwa5kuLTAiEAj56lHCT0sbPD/c3Fp88T5rjpTd1yKn4hGe5t9Lt1Qj4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46443},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"import":"./dist/index.js"}},"gitHead":"91fbf6049bb1d5cb60d02de0462a3d6c3c068214","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"digital-human-api","email":"npm@askaudience.de"},"repository":{"url":"git+https://github.com/t-moennich/digital-humans-api.git","type":"git"},"_npmVersion":"10.9.0","description":"MCP Server for AskAudience – expose synthetic DACH audiences as tools for AI assistants","directories":{},"_nodeVersion":"22.12.0","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.9.3","@types/node":"^20.19.37"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1773410960242_0.9960318405299735","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@askaudience/mcp-server","version":"0.2.0","keywords":["mcp","model-context-protocol","askaudience","market-research","dach","claude","ai-tools"],"author":{"name":"Tommy Orlik","email":"tommy.moennich@gmx.de"},"license":"MIT","_id":"@askaudience/mcp-server@0.2.0","maintainers":[{"name":"digital-human-api","email":"npm@askaudience.de"}],"homepage":"https://www.askaudience.de","bugs":{"url":"https://github.com/t-moennich/digital-humans-api/issues"},"bin":{"askaudience-mcp":"dist/index.js"},"dist":{"shasum":"31eea84f29d93fe1a012b6a62a4c1352db47a47e","tarball":"https://registry.npmjs.org/@askaudience/mcp-server/-/mcp-server-0.2.0.tgz","fileCount":14,"integrity":"sha512-LrrBzYc/NfoeEwXndZrybiwbkebGHrnQ/Ub8cJA/OFKGKFlqFu7XtW7rLte2EnoXXcbxKKfQwtj4/jWiQjW4MQ==","signatures":[{"sig":"MEYCIQCzE7KeCDdasGGc2N9zAbgWFwJdc91r02a7A6E6ng4TNAIhAMWy8clYOC2S77foyJW8xpdtQhaPj5px2hbIhPy8SnMx","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47509},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"import":"./dist/index.js"}},"gitHead":"14bf7c5a3f42ecbc0a47b1b9f6452cd68b6eb441","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"digital-human-api","email":"npm@askaudience.de"},"repository":{"url":"git+https://github.com/t-moennich/digital-humans-api.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP Server for AskAudience – expose synthetic DACH audiences as tools for AI assistants","directories":{},"_nodeVersion":"22.22.0","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.9.3","@types/node":"^20.19.37"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.0_1773467303611_0.6793685175053468","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@askaudience/mcp-server","version":"0.2.1","keywords":["mcp","model-context-protocol","askaudience","market-research","dach","claude","ai-tools"],"author":{"name":"Tommy Orlik","email":"tommy.moennich@gmx.de"},"license":"MIT","_id":"@askaudience/mcp-server@0.2.1","maintainers":[{"name":"digital-human-api","email":"npm@askaudience.de"}],"homepage":"https://www.askaudience.de","bugs":{"url":"https://github.com/t-moennich/digital-humans-api/issues"},"bin":{"askaudience-mcp":"dist/index.js"},"dist":{"shasum":"0f2a6614c3f8eb97bc93d5af33b97172730bfb85","tarball":"https://registry.npmjs.org/@askaudience/mcp-server/-/mcp-server-0.2.1.tgz","fileCount":14,"integrity":"sha512-/2L79hTxO+yBcxz1ZdMyEn0te9BZcg0oZ2F/s99XudEzErwEgH9NRdOXvtGNKv8ykYTaAZQSmjFmQzEHgn04kA==","signatures":[{"sig":"MEYCIQDWf/5qtsewtDmZ2Ns6yE1j2UjCLuEcA7RLktOcNqmsoAIhAMrXBrH/Otk8/kE7CWzoblVxyh5kfh2GrDSDXB9lysJ6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48664},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"import":"./dist/index.js"}},"gitHead":"bb3f0adf813dd12fd82f5f0b2bed2f0356493f99","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"digital-human-api","email":"npm@askaudience.de"},"repository":{"url":"git+https://github.com/t-moennich/digital-humans-api.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP Server for AskAudience – expose synthetic DACH audiences as tools for AI assistants","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.18","typescript":"^5.9.3","@types/node":"^20.19.37"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.1_1773662477509_0.24617900527539804","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@askaudience/mcp-server","version":"0.2.3","description":"MCP Server for AskAudience – expose synthetic DACH audiences as tools for AI assistants","keywords":["mcp","model-context-protocol","askaudience","market-research","dach","claude","ai-tools"],"license":"MIT","homepage":"https://www.askaudience.de","author":{"name":"Tommy Orlik","email":"tommy.moennich@gmx.de"},"repository":{"type":"git","url":"git+https://github.com/t-moennich/digital-humans-api.git"},"type":"module","bin":{"askaudience-mcp":"dist/index.js"},"main":"./dist/index.js","exports":{".":{"import":"./dist/index.js"}},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepublishOnly":"npm run build","test":"vitest run"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"devDependencies":{"@types/node":"^20.19.37","typescript":"^5.9.3","vitest":"^4.0.18"},"engines":{"node":">=18.0.0"},"_id":"@askaudience/mcp-server@0.2.3","gitHead":"0e300025025bc75c870461c7c7b1201cd7f755d8","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/t-moennich/digital-humans-api/issues"},"_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-VEo3pRfITQ6+6+rEf2T3UiIiBeNBSp/j75Pt1+AMqyCN9iRz3kz+vWb9Spz534Y0XFwZ0eN3VuPtG8QllDVURQ==","shasum":"2c403513550ec7946aa544d039c712f62cd21109","tarball":"https://registry.npmjs.org/@askaudience/mcp-server/-/mcp-server-0.2.3.tgz","fileCount":14,"unpackedSize":48804,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIA/M90iUhgBG2/f/o8XZ5AgQYFyaIiGIpnIHK9dHDWYXAiEAnkOH2zo01VAV39ZhbFUaj+gK6ywpmpSN5922DGlovnQ="}]},"_npmUser":{"name":"digital-human-api","email":"npm@askaudience.de"},"directories":{},"maintainers":[{"name":"digital-human-api","email":"npm@askaudience.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.2.3_1773666199609_0.4957826919792576"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-13T14:09:20.133Z","modified":"2026-03-16T13:03:19.858Z","0.1.0":"2026-03-13T14:09:20.411Z","0.2.0":"2026-03-14T05:48:23.765Z","0.2.1":"2026-03-16T12:01:17.655Z","0.2.3":"2026-03-16T13:03:19.737Z"},"bugs":{"url":"https://github.com/t-moennich/digital-humans-api/issues"},"author":{"name":"Tommy Orlik","email":"tommy.moennich@gmx.de"},"license":"MIT","homepage":"https://www.askaudience.de","keywords":["mcp","model-context-protocol","askaudience","market-research","dach","claude","ai-tools"],"repository":{"type":"git","url":"git+https://github.com/t-moennich/digital-humans-api.git"},"description":"MCP Server for AskAudience – expose synthetic DACH audiences as tools for AI assistants","maintainers":[{"name":"digital-human-api","email":"npm@askaudience.de"}],"readme":"# @askaudience/mcp-server\n\nModel Context Protocol (MCP) server that exposes **AskAudience** as tools for AI assistants — Claude Desktop, Cursor, and any other MCP-compatible client.\n\nAskAudience provides synthetic Digital Humans based on real European survey respondents (ESS R11 + WVS W7). Run market research in seconds — with **Ø 94% accuracy from real survey responses** (verified against ESS R11, n=165, 6 dimensions).\n\n## 🎯 Kostenlos testen\n\n**25 Credits gratis — keine Kreditkarte nötig.**\nRegistriere dich mit deiner geschäftlichen E-Mail-Adresse und teste den Node sofort.\n\n👉 [Jetzt kostenlos starten](https://www.askaudience.de/try)\n\n## Prerequisites\n\n- Node.js ≥ 18\n- An AskAudience API key — get one at [askaudience.de/console](https://askaudience.de/console)\n\n## Quick Start (Claude Desktop)\n\nAdd the following to your Claude Desktop config file:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"askaudience\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@askaudience/mcp-server\"],\n      \"env\": {\n        \"ASKAUDIENCE_API_KEY\": \"aa_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You will see the AskAudience tools available in the tool panel.\n\n## Running Manually\n\n```bash\n# stdio (default — for Claude Desktop / Cursor)\nASKAUDIENCE_API_KEY=aa_... npx @askaudience/mcp-server\n\n# SSE transport (HTTP server — for web clients)\nASKAUDIENCE_API_KEY=aa_... TRANSPORT=sse PORT=3000 npx @askaudience/mcp-server\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `ASKAUDIENCE_API_KEY` | **Yes** | — | Your API key (`aa_...`) |\n| `ASKAUDIENCE_BASE_URL` | No | `https://askaudience.de/api/v1` | Override the API base URL |\n| `TRANSPORT` | No | `stdio` | `stdio` or `sse` |\n| `PORT` | No | `3000` | HTTP port (SSE transport only) |\n\n## Available Tools\n\n### Audience Tools\n\n#### `askaudience_create_audience`\nCreate a new synthetic target audience with demographic filters.\n\n```\nParameters:\n  name          string   Required. Audience display name\n  description   string   Optional description\n  sampleSize    number   Number of digital humans (default: 50)\n  filters       object   Demographic filters:\n    ageRange      { min, max }\n    gender        \"male\" | \"female\" | \"diverse\"\n    locations     string[]    e.g. [\"Berlin\", \"München\"]\n    jobTitles     string[]\n    jobSearch     string      Free-text job filter\n    archetype     string      e.g. \"career_driven\"\n    countryCode   \"DE\" | \"AT\" | \"CH\"\n    sourceDataset \"ess\" | \"wvs\"\n```\n\n#### `askaudience_ask_audience`\nAsk a question to an audience. Returns individual answers + aggregated distribution.\nCost: **5 credits × sample size**\n\n```\nParameters:\n  audienceId      string   Required\n  question        string   Required\n  sampleSize      number   default: 20\n  responseFormat  \"text\" | \"likert_5\" | \"likert_7\" | \"yes_no\" | \"rating_1_10\"\n```\n\n#### `askaudience_compare_audiences`\nAsk the same question to multiple audiences and compare responses side-by-side.\nCost: **5 credits × sample size × number of audiences**\n\n```\nParameters:\n  audienceIds     string[]  Required (min 2)\n  question        string    Required\n  sampleSize      number    per audience, default: 10\n  responseFormat  string\n```\n\n#### `askaudience_export_audience`\nExport audience demographic data as JSON or CSV. Cost: **1 credit**\n\n```\nParameters:\n  audienceId  string   Required\n  format      \"json\" | \"csv\"   default: json\n```\n\n### Twin Tools\n\n#### `askaudience_search_digital_humans`\nSearch for individual synthetic personas by free-text and filters. Cost: **2 credits**\n\n```\nParameters:\n  query    string   Required. Searches name, location, job, description\n  filters  object   { gender, ageMin, ageMax, location, interests[] }\n  limit    number   default: 20\n```\n\n#### `askaudience_ask_digital_human`\nAsk a single persona a question with grounded response. Cost: **5 credits**\n\n```\nParameters:\n  twinId           string   Required\n  question         string   Required\n  responseFormat   string   default: text\n  context          string   Optional background info\n  includeReasoning boolean  default: false\n```\n\n### Usage Tools\n\n#### `askaudience_get_usage`\nCheck credit balance, plan, and request statistics. **Free**\n\n```\nParameters:\n  period  \"day\" | \"week\" | \"month\"   default: month\n```\n\n### Survey Tools\n\n#### `askaudience_create_survey`\nRun a multi-question survey against an audience (async). Cost: **5 × twins × questions**\n\n```\nParameters:\n  audienceId      string   Required\n  title           string   Required\n  description     string\n  twinSampleSize  number   default: 50\n  questions       Array<{\n    id:       string\n    type:     \"open_text\" | \"likert_5\" | \"likert_7\" | \"multiple_choice\"\n              | \"single_choice\" | \"rating_1_10\" | \"yes_no\"\n    text:     string\n    options?: string[]   (required for choice types)\n    required: boolean\n  }>\n```\n\n#### `askaudience_get_survey_status`\nPoll survey status (DRAFT → RUNNING → COMPLETED | FAILED). Cost: **1 credit**\n\n```\nParameters:\n  surveyId  string   Required\n```\n\n#### `askaudience_export_survey`\nExport completed survey results. Cost: **1–2 credits**\n\n```\nParameters:\n  surveyId  string   Required\n  format    \"json\" | \"csv\"   default: json\n```\n\n## Example Prompts for Claude\n\nOnce configured, you can ask Claude:\n\n> \"Create a target audience of women aged 30-45 in Berlin working in marketing, then ask them how important sustainability is when making purchase decisions.\"\n\n> \"Search for software engineers in München and ask the top result what they think about working remotely.\"\n\n> \"Compare how our 'Young Urban' and 'Traditional Rural' audiences respond to the question: Is AI a threat or an opportunity?\"\n\n> \"Check my AskAudience credit usage for this month.\"\n\n## SSE Transport (HTTP Mode)\n\nFor web-based MCP clients or custom integrations:\n\n```bash\nASKAUDIENCE_API_KEY=aa_... TRANSPORT=sse PORT=3000 npx @askaudience/mcp-server\n```\n\nEndpoints:\n- `GET /sse` — Establish SSE connection\n- `POST /message?sessionId=<id>` — Send messages\n- `GET /health` — Health check\n\n## Credits\n\n| Operation | Credits |\n|-----------|---------|\n| Create audience | 3 |\n| Ask audience (per twin) | 5 |\n| Compare audiences (per twin per audience) | 5 |\n| Export audience | 1 |\n| Search twins | 2 |\n| Ask twin | 5 |\n| Create + run survey (per twin × question) | 5 |\n| Get survey status | 1 |\n| Export survey results | 1–2 |\n| Get usage | 0 |\n\n## License\n\nMIT\n\n---\n\nBuilt for [AskAudience](https://askaudience.de) — Grounded synthetic audiences for European market research.\n","readmeFilename":"README.md"}