Skip to content
MCP server

Aetherya

MCP server that runs decision tests on a synthetic audience for studies, audits and copy

Answered our latest tool-list check 2 hours ago with 27 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Platforms
API, CLI
Runs
Locally or Remotely
Version
1.0.5
Listing updated
today

Similar MCP servers

About Aetherya

Aetherya is an MCP server for analytics and data. It can run locally on your machine or as a hosted remote server.

The Aetherya MCP server lets an AI client send a decision to Aetherya's simulation engine and get back results from a synthetic audience. The package on npm is @aetherya/mcp and it runs over stdio, while a hosted endpoint is also listed for streamable HTTP. Access requires an Aetherya API key, which the registry says is created in the app's settings.

The registry describes four kinds of test: studies, site audits, copy tests and post simulations. Each one asks how a population of simulated people would respond to an option, so a team can compare wording or layouts before publishing them to real audiences.

The server suits product, marketing and UX teams that already work inside an MCP-capable assistant and want pre-launch checks without leaving it. The website describes a separate consulting service and a self-serve product called Thesia; this listing covers only the MCP server.

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.aetherya.ai/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.aetherya.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.aetherya.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.aetherya.ai/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.aetherya.ai/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://mcp.aetherya.ai/mcp

Enter a Name (for example "Aetherya"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.aetherya.ai/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • AETHERYA_API_KEYAetherya API key (aeth_live_...) from app.aetherya.ai, Settings, API keysRequired

Tools this server provides (27)

Read directly from the server.

8 of 27 tools say they're read-only. 19 of 27 tools say they can delete or change data.

From the server's own tool annotations; not verified by us.

aetherya_list_capabilitiesSays read-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_estimateSays read-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_plan_studySays it can change data
Give Aetherya a decision you need to make, in plain English, and it designs the study, picks or builds the audience, prices it, and runs it — then writes a decision brief. Use this when you do not already know which research method fits; use aetherya_run_study when you do. It can also simulate a whole funnel (an ad leading to a landing page, and which call to action people take there): describe th
aetherya_confirm_studySays it can change data
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
aetherya_readSays it can change data
Myrias instant read. Reads 2-5 variants against a census-weighted synthetic population for a market, in seconds, and returns each variant's predicted action propensity, its lift over the control, and which demographic archetypes favour it. A variant can be copy (text), a live page (url), an image (image_path, image_url or image_base64) or a video (video_path). Media reads are single-kind: images o
aetherya_run_studySays it can change data
Run a Research Lab study — pricing sensitivity, message testing, concept testing, focus groups — against a synthetic audience and get a structured verdict with segment breakdowns, objections and representative reactions. Call aetherya_list_capabilities first to pick a method and see the inputs it needs. Results are SIMULATED predicted behaviour, not feedback from real users.
aetherya_test_copySays it can change data
Compare 2-5 copy variants — headlines, value propositions, ad or email copy — against a synthetic audience, and get a ranked verdict with predicted action propensity, comprehension and trust per variant, plus the objections each raises. Results are SIMULATED predicted reactions, not feedback from real users.
aetherya_audit_siteSays it can change data
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), p
aetherya_test_flowSays it can change data
Simulate people who arrive from an ad (image, video or copy), land on a page, and take one of several exits (for example book a consultation, open the plan form, or leave). Reports the exit split per arm. Pass rewrites to compare a changed ad and page copy against the original on the same audience. The first call quotes the cost and starts nothing; call again with accept_cost true once the user ag
aetherya_ask_audienceSays it can change data
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
aetherya_simulate_postSays it can change data
Run a post (X, LinkedIn, Instagram, Facebook) or email through a synthetic audience and get predicted engagement, sentiment and representative reactions before publishing. Starts the run and waits briefly; collect with aetherya_get_result kind 'post_simulation'. Results are SIMULATED reactions, not real engagement.
aetherya_cancelSays it can change 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_list_runsSays read-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.
aetherya_get_resultSays read-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 SIMULAT
aetherya_get_audit_resultSays read-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_briefSays it can change data
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 n
aetherya_share_resultSays it can change data
Mint a shareable URL for a completed study, audit or creative comparison so someone without an Aetherya account can read the findings. Use it after aetherya_get_brief when the user wants to send the results to a colleague or client, or post them. The link is PUBLIC to anyone who has it. A study shared without options gets its public link plus a preview card for posting; pass expires_in or a passwo
aetherya_pretest_reportSays it can change data
Assemble a markdown pretest report (how we worked, one section per set, what the results mean, sealed predictions appendix) from finished simulations. Deterministic unless generateFixes is true (then the model drafts fixes and a one-line summary per set, if enabled on the account); otherwise the recommended fixes are left as placeholders for the analyst. Returns the markdown plus claim-lint warnin
aetherya_compare_creativesSays it can change data
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
aetherya_pretest_videoSays it can change data
Pretest a short video (mp4, mov, webm; max 512 MB, 10 minutes) against a synthetic audience: hook score, attention curve, drop-off points. Uploads the file (video_path on this machine, or video_url), splits it into scenes, then returns status 'needs_price_confirmation' with the quote. The quote exists only after preparing, and the draft is free EXCEPT speech-to-text: when you pass no transcript_sr
aetherya_seal_predictionSays it can change data
Lock a prediction (a creative comparison ranking, a video analysis, a study or a manual payload) with a SHA-256 hash and timestamp, so it can later be compared with what really happened. Pass source_id to seal a finished simulation, or payload for a manual prediction. Returns the id, hash and sealed payload.
aetherya_verify_predictionSays read-only
Recompute the hash of a sealed prediction and report whether it still matches the stored one.
aetherya_record_outcomeSays it can change data
Attach what actually happened to a sealed prediction (append-only) and get the evaluation. creative_comparison actual: {metric:'ctr', values:[{creativeId?|variant?, value, impressions?, clicks?}]}; impressions and clicks let Aetherya record the result for calibration (see calibrationRecorded). video_analysis actual: {threeSecondHoldPct?, biggestDropSec?, watchedFullPct?}. Other kinds: any object.
aetherya_create_intake_linkSays it can change data
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_list_intake_filesSays read-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_audiencesSays read-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 i
aetherya_create_audienceSays it can change data
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.

What it does

Synthetic audience testing
Runs a decision or piece of content past a simulated population and returns how it lands.
Site audits
Tests a website or page through the simulated audience to surface likely friction points.
Copy testing
Compares wording options against simulated respondents before anything goes live.
Post simulation
Simulates how an audience might react to a social post before publishing.
Two transport options
Available as a local stdio package on npm or as a remote streamable-HTTP endpoint.

Good for

  • Pre-test landing page copy before running paid campaigns
  • Run a UX audit of a site before a redesign ships
  • Compare social post variants against a simulated audience
  • Stress-test a market entry or pricing decision before committing budget

Aetherya FAQ

How do I authenticate the MCP server?

The npm package requires the AETHERYA_API_KEY environment variable, a key starting with aeth_live_ that the registry says is generated in the app under Settings, API keys.

Which transports does it support?

The registry lists stdio through the @aetherya/mcp npm package and a remote streamable-HTTP endpoint at mcp.aetherya.ai.

What is the current package version?

The registry entry lists version 1.0.5 of @aetherya/mcp.

How do I add Aetherya to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.aetherya.ai/mcp

What are the best alternatives to Aetherya?

The closest alternatives to Aetherya are iMario, effectsize, MCP, A/B Test Sample Size Calculator MCP and Shynet MCP.

Where this comes from

  • Description: written from the project's website and its MCP Registry entry.
  • Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers