Aetherya

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/aetherya-ai-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

8 read · 17 write · 2 delete

Secrets

2 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (27)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• aetherya_ask_audienceAsk ONE synthetic persona a question (secondary)

  SECONDARY TOOL. Pose a question to a SINGLE synthetic persona and get one predicted, in-character response — good for an open-ended 'would this confuse someone like this?' sounding-out. The answer is SIMULATED (one persona's predicted reaction), not a real person, and ONE persona is not an audience: it carries no distribution and no disagreement, so never report it as what 'users' or 'the audience' think. For a finding you can act on, use aetherya_test_copy (compare variants) or aetherya_run_study / aetherya_plan_study (a panel with a spread of reactions).

• aetherya_audit_siteAudit a site with a synthetic audience

  Run a behavioral simulation: a synthetic audience visits a URL and predicts where real users would hesitate, get confused, or drop off, plus messaging-clarity and UX friction findings with concrete fixes. Ideal for evaluating a freshly built or changed page and getting actionable UX/messaging improvements in the same loop. To find out how people experience a flow (sign-up, onboarding, checkout), pass tasks and start_url: the simulated visitors then walk the flow step by step instead of touring the site. By default they stop before the final submit, so nothing is created or bought; pass allow_t…

• aetherya_cancelCancel a running Aetherya runcan change or delete data

  Stop a study, instant read, plan, audit or post simulation that is still running. Use it when the user changes their mind or a run was started with the wrong inputs. Finished runs are not affected.

• aetherya_compare_creativesCompare image creatives

  Compare 2+ image creatives (thumbnails, display banners, social images) against a synthetic audience. Creates the experiment, uploads the images, attaches the audience and drafts the comparison (free). It then returns status 'needs_price_confirmation' with the quoted simulation sessions; nothing is spent until you re-call with accept_sessions >= the quote (pass accept_sessions up front to skip the pause). To confirm a draft already created, pass comparison_id + accept_sessions only. Cost scales with creatives x personas; an audience group is capped at 10 personas per segment. choice_task adds …

• aetherya_confirm_studyApprove, answer, cancel or retry a planned study

  Respond to a plan from aetherya_plan_study. Use action 'confirm' with accept_sessions to approve the quoted cost and start the run — this is the point at which simulation sessions are spent, so check with the user first. Use 'answer' to reply to the clarifying questions (answers with the option ids the user picked, or answer for one free-text reply), 'cancel' to abandon the plan, or 'retry' after a failure. After confirming, the run continues and returns its decision brief when it finishes.

• aetherya_create_audienceCreate a synthetic audience

  Create synthetic-audience personas to simulate against. Describe who you want to model and get back personas (with ids) you can then target as the 'audience' in aetherya_audit_site, aetherya_test_copy, or aetherya_ask_audience. These are SIMULATED personas (engine-generated), not real people. Returns the created personas inline.

• aetherya_create_intake_linkCreate a client file-intake link

  Create a secret upload link to send a client so they can drop creative files (images, video) for pretesting. Returns the url and expiry; treat the url as a secret and share it only with the client. Needs a workspace admin or manager, and the feature must be enabled for the workspace (otherwise a clear 'not enabled' message).

• aetherya_estimateEstimate the cost of a simulation before running itread-only

  Quote how many simulation sessions a run would cost, and roughly what share of your plan it would consume, before committing to it. Free — this never starts a simulation. Use it to size an audience or shorten a study when headroom is tight.

• aetherya_get_audit_resultGet the result of a synthetic-audience auditread-only

  Fetch the result of an audit started by aetherya_audit_site, using its job_id. Returns the full simulated behavioral findings once complete, or a 'running' status to poll again. Results are SIMULATED predicted behavior, not real users.

• aetherya_get_briefGet the plain-language decision brief for a finished run

  Turn a finished study, audit, read or post simulation into a short decision brief: the question, a direct answer, the reasoning with supporting simulated reactions, the risks, and what to do next. This is what you hand a human — use it instead of relaying raw metrics. Reuses the stored brief when one exists, so repeat calls are free (unless language, register or regulated is given: that writes a new brief with a model call). Everything in it comes from SIMULATED behaviour, not real-user research.

• aetherya_get_resultGet the result of an Aetherya runread-only

  Fetch the findings of a run started by aetherya_run_study, aetherya_test_copy, aetherya_audit_site, aetherya_plan_study, aetherya_read, aetherya_simulate_post, aetherya_compare_creatives, aetherya_pretest_video or aetherya_test_flow, using the kind and id from that tool's response. Simulations run longer than a single tool call, so this is the normal way to collect results. All results are SIMULATED predicted behaviour, not real-user data.

• aetherya_list_audiencesList your synthetic audiencesread-only

  List the synthetic audiences (simulated personas) in this workspace: their overall shape (where they are, what they do, how much is actually filled in) plus a sample with ids. These are simulated personas, not real people, and a stored persona pool is usually narrower than the audience a decision is about — read the distribution before targeting by id, and prefer describing the audience you want in aetherya_plan_study when the pool does not match it.

• aetherya_list_capabilitiesList what you can run and what plan headroom is leftread-only

  List the research methods this workspace can run — with the exact stimulus fields each one requires — plus remaining plan headroom and simulation-session balance. Call this before aetherya_run_study or aetherya_test_copy to pick a method and check cost headroom. Everything Aetherya runs is a SIMULATION of a synthetic audience, not real-user research.

• aetherya_list_intake_filesList files uploaded through an intake linkread-only

  List the files a client uploaded through an intake link (name, type, size, status, set label, a short-lived download url). The feature must be enabled for the workspace.

• aetherya_list_runsList recent Aetherya runsread-only

  List the workspace's recent simulations across studies, instant reads, plans, audits and post simulations, newest first, with the kind and id to pass to aetherya_get_result or aetherya_get_brief. Use it to find earlier work instead of re-running it.

Signals

Weekly downloads

36

Last release

Oct 19, 2026 (9 days ago)

Last package publish

Oct 19, 2026 (9 days ago)

From the package registry.

Details

Registry name

ai.aetherya/mcp

Version

1.0.5

Auth

Bearer token, API key

Packages

npm @aetherya/mcp

License

License unknown

Website

aetherya.ai

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registry