{"name":"ai.aetherya/mcp","slug":"aetherya-mcp","title":"Aetherya","description":"Test decisions on a synthetic audience: studies, site audits, copy tests and post simulations.","url":"https://mcp.market/server/aetherya-mcp","rating":null,"grade":"B","score":79,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":18,"stars":null,"forks":null,"downloads_week":100,"last_push_at":null,"license":"MIT"},"uptime":{"percent":96,"checks":28,"ok":27,"last_checked_at":"2026-11-04T06:46:00.818Z","last_ok_at":"2026-11-04T06:46:00.818Z","latency_ms":550},"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":null,"website":"https://aetherya.ai","version":"1.0.5","remotes":[{"type":"streamable-http","url":"https://mcp.aetherya.ai/mcp","headers":[{"description":"Bearer followed by your Aetherya API key (aeth_live_...)","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@aetherya/mcp","version":"1.0.5","transport":{"type":"stdio"},"environmentVariables":[{"description":"Aetherya API key (aeth_live_...) from app.aetherya.ai, Settings, API keys","isRequired":true,"isSecret":true,"name":"AETHERYA_API_KEY"}]}],"tools":[{"name":"aetherya_ask_audience","description":"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).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"question":{"type":"string","minLength":1,"description":"The question to ask the synthetic audience (e.g. 'Would this pricing page confuse you?')."},"audience":{"type":"string","description":"Optional. A persona id or name from aetherya_list_audiences to answer as. If omitted, one of your synthetic audiences is chosen automatically."},"context":{"type":"string","description":"Optional. Background/situation for the audience to consider when answering."},"language":{"type":"string","description":"Optional. The language to answer in, e.g. 'English' or 'Romanian'. Personas answer in their own native language by default, which is correct for research but unreadable when you asked in another language. Set this to your own language unless you specifically want the persona's."}},"required":["question"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_audit_site","description":"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_test_signups only when the user explicitly allows test sign-ups. Payment is never submitted. For pages behind a login, pass credentials for a dedicated test account the user gave you. Results are SIMULATED (predicted behavior of a synthetic audience), not feedback from real users.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"The full URL of the page to audit (e.g. https://example.com/pricing)."},"audience":{"type":"string","description":"Optional. A synthetic audience to use: a persona id or name from aetherya_list_audiences, or a short free-text description (e.g. 'first-time SaaS buyers'). If omitted, Aetherya simulates a small mixed audience."},"focus":{"type":"string","description":"Optional. What to pay attention to, e.g. 'checkout flow', 'onboarding clarity', 'is the value proposition clear?'."},"objective":{"type":"string","description":"Optional. What you want to find out, in your own words, e.g. 'how do new users feel about our onboarding flow?'. Sent as written (not paraphrased); steers the simulated visitors and the report."},"start_url":{"type":"string","format":"uri","description":"Optional. Where a flow test begins, e.g. https://example.com/signup. Same site as url. Use together with tasks."},"tasks":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1,"description":"What the visitor tries to do, e.g. 'Create an account and reach the first screen'."},"instructions":{"type":"string","description":"Optional extra guidance for the visitor."},"expected_outcome":{"type":"string","description":"Optional. What counts as done, e.g. 'Lands on a welcome or dashboard screen'."}},"required":["title"],"additionalProperties":false},"maxItems":5,"description":"Optional flow test (max 5 tasks). Each simulated visitor walks the flow step by step and reports where they stall and how each step felt, instead of touring the site. Use it for 'how do people experience our sign-up / onboarding / checkout' questions, with start_url set to where the flow begins. Runs the ux_journey audit."},"allow_test_signups":{"type":"boolean","description":"Flow tests only. Default false: visitors stop before the final submit, so no account is created and no order is placed. Set true only if the user explicitly allows test sign-ups on this site. Payment is never submitted either way."},"credentials":{"type":"object","properties":{"mode":{"type":"string","enum":["form","basic"],"description":"'form': a login page; 'basic': HTTP basic auth."},"login_url":{"type":"string","format":"uri","description":"Form mode: the login page URL, on the audited site."},"username":{"type":"string","minLength":1,"maxLength":320,"description":"Test account username or email."},"password":{"type":"string","minLength":1,"maxLength":512,"description":"Test account password."},"persona_login":{"type":"string","enum":["prelogin","persona"],"description":"'prelogin' (default): Aetherya logs in once and every visitor starts signed in. 'persona': each visitor logs in itself, which tests the login page too."},"allowed_hosts":{"type":"array","items":{"type":"string","minLength":1},"maxItems":5,"description":"Extra hosts the login may pass through (single sign-on), e.g. ['auth.example.com']."}},"required":["mode","username","password"],"additionalProperties":false,"description":"Use a dedicated test account. Sent once, stored encrypted, deleted when the run ends. Never use a real customer or admin account."},"scope":{"type":"object","properties":{"mode":{"type":"string","enum":["site","path","page"],"description":"'site', 'path' or 'page'."},"value":{"type":"string","description":"For 'path': a subtree like '/blog'. For 'page': a path or full URL."}},"required":["mode"],"additionalProperties":false,"description":"Optional. Restrict where visitors may go: 'site' (whole domain, default), 'path' (a subtree, value '/blog') or 'page' (one page, value a path or full URL)."},"num_agents":{"type":"integer","minimum":1,"maximum":10,"description":"How many simulated visitors walk the page. Default 3. Drives cost — quote it with aetherya_estimate (kind 'audit', audience_size = this number) before raising it."},"max_wait_seconds":{"type":"integer","minimum":0,"maximum":45,"description":"How long to wait inline before handing back an id to poll. Defaults to 45."}},"required":["url"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_cancel","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"type":"string","enum":["study","autopilot","audit","post_simulation"],"description":"The kind named in the run tool's response."},"id":{"type":"string","minLength":1,"description":"run_id for a study or read, autopilotId for a plan, job_id for an audit, or the post simulation id."}},"required":["kind","id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_compare_creatives","description":"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 a forced-choice round (choiceCost in the quote). Collect the ranking with aetherya_get_result kind 'creative_comparison'. Results are simulated, not real-user data.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Name for the comparison."},"platform":{"type":"string","enum":["google_display","facebook","instagram","google_search"],"description":"Where the creatives run."},"exposure":{"type":"string","enum":["glance","considered"],"description":"glance = a split-second scroll-past view."},"choice_task":{"type":"boolean","description":"Also run a forced-choice task (each persona picks one creative). Adds sessions; the quote shows choiceCost."},"audience_group_id":{"type":"string","description":"Audience group (see aetherya_list_audiences)."},"persona_ids":{"type":"array","items":{"type":"string"},"description":"Persona ids (see aetherya_list_audiences), instead of an audience group."},"creatives":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"description":"Short name for the creative."},"image_url":{"type":"string","description":"http(s) image, png/jpeg/webp, max 8 MB."},"image_base64":{"type":"string","description":"data:image/...;base64,... URL, max 8 MB."},"headline":{"type":"string","description":"Headline shown with the image."},"body":{"type":"string","description":"Body copy shown with the image."},"cta":{"type":"string","description":"Call-to-action text."},"concept":{"type":"string","description":"Creatives sharing a concept are grouped; the first is its representative."}},"required":["label"],"additionalProperties":false},"minItems":2,"maxItems":10,"description":"2-10 creatives to compare. Needed unless you pass comparison_id."},"accept_sessions":{"type":"number","exclusiveMinimum":0,"description":"Sessions you accept to spend; must cover the quote."},"comparison_id":{"type":"string","description":"Confirm and run a draft created by an earlier call."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_confirm_study","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"autopilot_id":{"type":"string","minLength":1,"description":"The autopilotId from aetherya_plan_study."},"action":{"type":"string","enum":["confirm","answer","cancel","retry"],"description":"'confirm' accepts the quoted cost and starts the run (requires accept_sessions). 'answer' replies to the clarifying questions (requires answers or answer). 'cancel' abandons the plan. 'retry' re-runs a failed plan."},"accept_sessions":{"type":"number","description":"Required for 'confirm': the exact sessions figure from the plan's estimate. Never invent it — a mismatch is rejected and re-quoted."},"answer":{"type":"string","minLength":1,"description":"For 'answer': a free-text reply to the (first) question asked. Prefer answers when the plan lists questions."},"answers":{"type":"array","items":{"type":"object","properties":{"questionId":{"type":"string","minLength":1,"description":"A question id from the plan's questions."},"optionId":{"type":"string","minLength":1,"description":"The id of the option the user picked."},"text":{"type":"string","minLength":1,"description":"The user's own words, when no option fits."}},"required":["questionId"],"additionalProperties":false},"maxItems":3,"description":"For 'answer': one entry per question from the plan's questions, with the optionId the user picked or their own text. A question left out keeps its default. Only relay what the user said."},"max_wait_seconds":{"type":"integer","minimum":0,"maximum":45,"description":"How long to wait inline after confirming before handing back an id. Defaults to 45."}},"required":["autopilot_id","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_create_audience","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"description":{"type":"string","description":"Who to simulate, in plain language (e.g. 'price-sensitive first-time SaaS buyers in Germany' or 'busy parents shopping for groceries online'). When provided, Aetherya engine-generates personas matching it; omit for a general-consumer audience."},"count":{"type":"integer","minimum":1,"maximum":25,"description":"How many synthetic personas to create (1-25, default 3)."},"category":{"type":"string","description":"Optional. A category/segment label for the audience (e.g. 'e-commerce', 'fintech')."},"market":{"type":"string","description":"Optional. Target market / locale as a country or region (e.g. 'US', 'DE', 'UK')."},"website_url":{"type":"string","format":"uri","description":"Optional. A site to infer the audience from — Aetherya analyzes it and generates personas that match its likely visitors."},"segments":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"description":"Stable id for the segment, e.g. 'loyal_buyers'."},"label":{"type":"string","minLength":1,"description":"Display name."},"description":{"type":"string","minLength":1,"description":"Who these people are."},"size":{"type":"number","exclusiveMinimum":0,"description":"Relative weight of the segment."},"relationship_to_brand":{"type":"string","description":"Free text, e.g. 'switched to a competitor last year'."},"brand_awareness":{"type":"string","enum":["unaware","aware","considering","customer","lapsed"],"description":"How familiar this segment is with the brand."}},"required":["key","label","description"],"additionalProperties":false},"maxItems":12,"description":"Optional. Explicit audience segments (max 12); weights follow 'size'. Builds a manual blueprint."},"brand_context":{"type":"object","properties":{"brand":{"type":"string","minLength":1,"description":"The brand under test."},"competitors":{"type":"array","items":{"type":"string","minLength":1},"maxItems":8,"description":"Up to 8 competitor brands."},"market":{"type":"string","description":"Market, e.g. 'Romania'."}},"required":["brand"],"additionalProperties":false,"description":"Optional. The brand under test and its competitors, so personas carry brand awareness for that market. Requires segments or website_url; otherwise it is rejected."},"language":{"type":"string","description":"Optional. Language for the personas, e.g. 'ro'."},"pack_name":{"type":"string","description":"Optional. Name for the saved audience pack."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_create_intake_link","description":"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).","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":120,"description":"Who or what the link is for, e.g. 'Acme spring banners'."},"expires_in_days":{"type":"integer","minimum":1,"maximum":30,"description":"Days until the link expires (1-30, default 14)."},"max_files":{"type":"integer","minimum":1,"maximum":50,"description":"Max files (default and cap 50)."},"max_total_mb":{"type":"integer","minimum":1,"maximum":2048,"description":"Max total size in MB (default and cap 2048)."}},"required":["label"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_estimate","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"type":"string","enum":["study","copy_test","post","survey","audit"],"description":"What you are about to run."},"method":{"type":"string","description":"Required when kind is 'study' — the research method id."},"audience_size":{"type":"integer","description":"Simulated respondents / audience size."},"variants":{"type":"integer","description":"Number of copy variants, for a copy test."},"questions":{"type":"integer","description":"Number of survey questions."},"depth":{"type":"string","enum":["single_pass","deliberation","deep"],"description":"Engagement depth. Cost multiplier: 1x / 2x / 4x."}},"required":["kind"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_get_audit_result","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"job_id":{"type":"string","minLength":1,"description":"The job_id returned by aetherya_audit_site (or an audit report id)."},"include":{"type":"array","items":{"type":"string","enum":["heatmap","journeys"]},"description":"Extra detail to fetch alongside the report. 'journeys' is the step-by-step path each simulated visitor took; 'heatmap' is where attention landed per page. Both are large — ask for them only when the summary is not enough to answer the question."}},"required":["job_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_get_brief","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"type":"string","enum":["study","audit","post_simulation"],"description":"'study' for a run_study / test_copy / plan_study / read run id, 'audit' for an audit report id, 'post_simulation' for a simulate_post id."},"id":{"type":"string","minLength":1,"description":"The run id for a study, or the reportId (not the job_id) for an audit."},"regenerate":{"type":"boolean","description":"Re-write a brief that already exists. Costs another model call — leave unset to reuse the stored one. Passing language, register or regulated also writes a new brief."},"language":{"type":"string","description":"Optional. Brief language (e.g. 'ro'); sent as reportLanguage."},"register":{"type":"string","enum":["formal","neutral"],"description":"Optional. Tone register of the brief."},"regulated":{"type":"boolean","description":"Optional. Set true for regulated sectors (claims are checked)."}},"required":["kind","id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_get_result","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"type":"string","enum":["audit","study","autopilot","post_simulation","creative_comparison","video_analysis","flow"],"description":"Which kind of run to fetch. Use the kind named in the run tool's `next` hint."},"id":{"type":"string","minLength":1,"description":"The id from the run tool — job_id for audits, run_id for studies and copy tests, autopilotId for plans, the simulation id for a post simulation, the comparisonId for a creative comparison, the experimentId for a video analysis, or the flowRunId for a flow test."}},"required":["kind","id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_list_audiences","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_list_capabilities","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"section":{"type":"string","enum":["all","methods","limits"],"description":"'methods' lists the research methods available and the inputs each needs. 'limits' returns just your remaining plan headroom and session balance. Default 'all'."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_list_intake_files","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"link_id":{"type":"string","minLength":1,"description":"Intake link id from aetherya_create_intake_link."}},"required":["link_id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_list_runs","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"type":"string","enum":["all","study","autopilot","audit","post_simulation"],"description":"Only this kind of run. Default 'all'. Studies include copy tests and instant reads."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"How many to return. Default 15."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_plan_study","description":"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 the ad, the page URL and the goals in the objective. It always stops for your approval at a price before spending anything: expect status 'needs_price_confirmation' and answer it with aetherya_confirm_study. Call it again with autopilot_id to check on a plan already running. Results are SIMULATED predicted behaviour, not real-user research.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"objective":{"type":"string","minLength":1,"description":"What you need to decide, in plain English — e.g. 'should we price the starter plan at 29 or 49 for early-stage dev teams?'. Starts a new plan. Omit when checking an existing one."},"autopilot_id":{"type":"string","minLength":1,"description":"Check an existing plan instead of starting one. Mutually exclusive with objective."},"audience_id":{"type":"string","description":"Optional saved audience pack / persona group id (UUID) to draw the sample from."},"asset_ids":{"type":"array","items":{"type":"string"},"maxItems":6,"description":"Optional. Ids of ads the user already uploaded to Aetherya (images or videos). Pass them when the objective is about those ads, e.g. a funnel: 'our Instagram ad leads to example.com/offer; do people book a call or use the plan form?'."},"market":{"type":"string","description":"Optional. Target market, e.g. 'RO'."},"language":{"type":"string","description":"Optional. Report language, e.g. 'ro'."},"register":{"type":"string","enum":["formal","neutral"],"description":"Optional. Report tone register."},"max_wait_seconds":{"type":"integer","minimum":0,"maximum":45,"description":"How long to wait inline before handing back an id. Defaults to 45."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_pretest_report","description":"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 warnings to resolve before sending. Seals each set's prediction as a side effect. Results are simulated, not real-user data. For a branded PDF, open the same report in the app at /dashboard/ad-lab/pretest and use Download PDF.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"description":"Report title."},"language":{"type":"string","enum":["ro","en"],"description":"Report language. Defaults to en."},"register":{"type":"string","enum":["formal","neutral"],"description":"Writing register. Defaults to neutral."},"regulated":{"type":"boolean","description":"True for regulated sectors; claims are linted harder."},"generateFixes":{"type":"boolean","description":"Ask the model to draft 3-5 concrete fixes and a one-line summary per set. Default false."},"sets":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["creative_comparison","video_analysis","research_run"],"description":"Which kind of finished run this set is."},"id":{"type":"string","minLength":1,"description":"Comparison, video analysis or research run id."},"label":{"type":"string","minLength":1,"description":"Section heading for this set."},"assumptions":{"type":"string","description":"Assumptions to state in this set's section."}},"required":["kind","id","label"],"additionalProperties":false},"minItems":1,"maxItems":12,"description":"1-12 finished runs, one report section each."}},"required":["title","sets"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_pretest_video","description":"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_srt, preparing charges 0.25 to 6 simulation sessions for transcription up front. Analysis cost is personas x 5 + scenes x 0.5 sessions, minimum 10, max 60 personas. Nothing more is spent until you re-call with accept_sessions >= the quote (pass it up front to skip the pause). If preparing is still running the tool returns 'preparing' with experiment_id, video_id and prepare_job_id: call again with those. Collect with aetherya_get_result kind 'video_analysis'. Results are simulated, not real-user data.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Name for the pretest."},"video_path":{"type":"string","description":"Local mp4/mov/webm file (disabled when AETHERYA_MCP_ALLOW_LOCAL_FILES=0)."},"video_url":{"type":"string","description":"http(s) link to a video file."},"transcript_srt":{"type":"string","description":"SRT transcript; skips the speech-to-text charge."},"transcribe_language":{"type":"string","pattern":"^[a-z]{2}(-[A-Z]{2})?$","description":"e.g. ro or en-US."},"hook_windows":{"type":"boolean","default":true,"description":"Split scenes into hook windows so the opening seconds are scored on their own. Default true."},"placement":{"type":"string","enum":["generic","reels","shorts","tiktok","facebook_feed","youtube_instream"],"default":"generic","description":"Where the video runs."},"audience_group_id":{"type":"string","description":"Audience group (see aetherya_list_audiences)."},"persona_ids":{"type":"array","items":{"type":"string"},"description":"Persona ids, instead of an audience group."},"segments":{"type":"array","items":{"type":"string"},"maxItems":12,"description":"Limit an audience group to these segment ids."},"accept_sessions":{"type":"number","exclusiveMinimum":0,"description":"Sessions you accept to spend; must cover the quote."},"experiment_id":{"type":"string","description":"Resume: from an earlier call."},"video_id":{"type":"string","description":"Resume: from an earlier call."},"prepare_job_id":{"type":"string","description":"Resume: from an earlier call."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_read","description":"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 or videos cannot be mixed with copy, pages or each other. The first read of a new image takes about 30-45 s and may come back running (collect it with aetherya_get_result). A video is uploaded and prepared first, about 1-2 min. Much cheaper and faster than aetherya_test_copy, which is the deeper follow-up. Counts against the monthly read allowance, not simulation sessions. Results are SIMULATED, not real-user data.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"variants":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"description":"The copy to read, verbatim."},"url":{"type":"string","format":"uri","description":"A live page to read, http or https."},"image_path":{"type":"string","minLength":1,"description":"Local png, jpeg or webp file (disabled when AETHERYA_MCP_ALLOW_LOCAL_FILES=0)."},"image_url":{"type":"string","format":"uri","description":"http(s) image, png/jpeg/webp, max 8 MB."},"image_base64":{"type":"string","minLength":1,"description":"data:image/...;base64,... URL, max 8 MB."},"video_path":{"type":"string","minLength":1,"description":"Local mp4, mov, m4v or webm file (disabled when AETHERYA_MCP_ALLOW_LOCAL_FILES=0)."},"label":{"type":"string","description":"Optional short name for this variant."},"is_control":{"type":"boolean","description":"The current/baseline variant. Exactly one; defaults to the first."}},"additionalProperties":false},"minItems":2,"maxItems":5,"description":"2-5 variants to read side by side. Images and videos are read on their own, not mixed with other kinds."},"where":{"type":"string","enum":["Homepage hero","Landing page","Pricing page","Paid ad","Sales email","Social post","x","instagram","facebook","youtube","tiktok","reels","shorts"],"description":"Where the variants appear. Defaults to 'Landing page'."},"target_action":{"type":"string","description":"The action the variants should drive, e.g. 'Sign up'."},"market":{"type":"string","description":"Who to read against, as a place: 'United States', 'Germany', 'RO'. Defaults to the US."},"audience":{"type":"string","format":"uuid","description":"Read against a saved audience (persona group id from aetherya_list_audiences) instead of a market."},"title":{"type":"string","description":"Optional name for the read in your run history."}},"required":["variants"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_record_outcome","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Sealed prediction id."},"actual":{"type":"object","additionalProperties":{},"description":"The observed outcome."},"source":{"type":"string","description":"Where the numbers came from, e.g. 'client_email_2026-10-09'."},"note":{"type":"string","description":"Optional free-text note stored with the outcome."}},"required":["id","actual"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_run_study","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"method":{"type":"string","description":"Research method id, from aetherya_list_capabilities — e.g. 'messaging_test', 'concept_test', 'feature_adoption', 'pricing_van_westendorp', 'focus_group'."},"title":{"type":"string","minLength":1,"description":"Short name for this study, e.g. 'Q3 pricing band for Pro'."},"objective":{"type":"string","minLength":1,"description":"The decision this study should inform."},"stimulus":{"type":"object","additionalProperties":{},"description":"The method's own stimulus fields, keyed by the `key` values in that method's stimulusSchema (see aetherya_list_capabilities). A variant_list field takes an array of { text, isControl } objects, 2-5 entries."},"hypothesis":{"type":"string","description":"Optional. What you expect to find."},"audience_size":{"type":"integer","minimum":5,"maximum":200,"description":"Simulated respondents. Defaults to the method's own default (usually 30). Drives cost."},"audience":{"type":"string","description":"Optional saved audience (persona group) id to draw the sample from. Omit to draw from your existing synthetic audience."},"market":{"type":"string","description":"Optional. Target market, e.g. 'RO'."},"language":{"type":"string","description":"Optional. Report language, e.g. 'ro'."},"register":{"type":"string","enum":["formal","neutral"],"description":"Optional. Report tone register."},"regulated":{"type":"boolean","description":"Optional. True for regulated sectors (claims are checked)."},"depth":{"type":"string","enum":["single_pass","deliberation","deep"],"description":"How deeply each respondent engages. Cost multiplier: single_pass 1x, deliberation 2x, deep 4x."},"scenario":{"type":"string","description":"Optional emotional condition from the method's supportedConditions, e.g. 'budget_anxiety'."},"accept_sessions":{"type":"number","description":"Only needed after a 'needs_price_confirmation' result. Pass back the exact requiredSessions value from that response to proceed."},"max_wait_seconds":{"type":"integer","minimum":0,"maximum":45,"description":"How long to wait inline before handing back an id to poll. Defaults to 45."}},"required":["method","title","objective","stimulus"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_seal_prediction","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"source_kind":{"type":"string","enum":["creative_comparison","video_analysis","research_study","manual"],"description":"What is being sealed."},"source_id":{"type":"string","description":"Id of the comparison, video analysis or study run."},"label":{"type":"string","minLength":1,"description":"Short name, e.g. 'Spring campaign, 3 creatives'."},"payload":{"type":"object","additionalProperties":{},"description":"Prediction content; required for 'manual'."}},"required":["source_kind","label"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_share_result","description":"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 password for a private, expiring link instead.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"kind":{"type":"string","enum":["study","audit","creative_comparison"],"description":"'study' for a research run id, 'audit' for an audit report id, 'creative_comparison' for a compare_creatives comparison id."},"id":{"type":"string","minLength":1,"description":"The run id for a study, the reportId (not the job_id) for an audit, or the comparison id."},"expires_in":{"type":"string","enum":["7d","30d","90d","never"],"description":"How long the link stays live. Audits and comparisons default to 30d. A study with no expiry and no password gets its public link (stays live until the owner stops sharing it)."},"password":{"type":"string","description":"Optional password required to open the link. Never returned in the response."}},"required":["kind","id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_simulate_post","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"platform":{"type":"string","enum":["x","linkedin","instagram","facebook","email"],"description":"Where the post goes out."},"text":{"type":"string","minLength":1,"description":"The post (or email body) exactly as it would be published."},"objective":{"type":"string","description":"What the post is for, e.g. 'drive webinar signups'."},"link_url":{"type":"string","format":"uri","description":"Link attached to the post, if any."},"image_url":{"type":"string","format":"uri","description":"Public URL of an image attached to the post, if any."},"tone":{"type":"string","enum":["balanced","professional","casual"],"description":"Tone of the simulated comments. Default balanced."},"audience_size":{"type":"integer","minimum":10,"maximum":500,"description":"Simulated audience members. Default 100. Drives cost."},"persona_ids":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Specific personas (from aetherya_list_audiences) to use. Omit to use the workspace pool."},"accept_sessions":{"type":"number","description":"Only after a 'needs_price_confirmation' result: the exact requiredSessions value from it, re-sent to authorize the spend. Never guess it."}},"required":["platform","text"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_test_copy","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"variants":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"description":"One message variant — a headline, value proposition, or short copy block."},"label":{"type":"string","description":"Optional short name for this variant."},"is_control":{"type":"boolean","description":"Mark the current/baseline copy. Exactly one variant should be the control."}},"required":["text"],"additionalProperties":false},"minItems":2,"maxItems":5,"description":"2-5 copy variants to compare head-to-head."},"objective":{"type":"string","description":"What this copy should achieve, e.g. 'get developers to start a free trial'."},"where":{"type":"string","enum":["Homepage hero","Landing page","Paid ad","Sales email","Pricing page","Social post"],"description":"Where this copy appears."},"target_action":{"type":"string","enum":["Book a demo","Sign up","Buy","Click through","Trust the brand","Share internally"],"description":"The action the copy should drive."},"audience":{"type":"string","description":"Optional saved audience (persona group) id to test against."},"audience_size":{"type":"integer","minimum":10,"maximum":200,"description":"Simulated respondents. Default 30. Drives cost."},"accept_sessions":{"type":"number","description":"Only after a 'needs_price_confirmation' result: the exact requiredSessions value from that response, re-sent to authorize the spend. Never guess it."},"max_wait_seconds":{"type":"integer","minimum":0,"maximum":45,"description":"How long to wait inline before handing back an id to poll. Defaults to 45."}},"required":["variants"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_test_flow","description":"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 agrees. Collect results with aetherya_get_result kind 'flow'. Results are SIMULATED, not real-user data.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"page_url":{"type":"string","format":"uri","description":"The landing page the ads send people to."},"exits":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":120,"description":"What this exit is, e.g. 'Book a consultation'."},"primary":{"type":"boolean","description":"The exit that matters most. One exit should be primary; the first is used if none is."},"form_contains":{"type":"string","description":"Words found only in this exit's form or on its final button (not in the other exit's form), e.g. 'Phone' or 'Generate my plan'. The most reliable signal."},"url_contains":{"type":"string","description":"Part of the thank-you URL, e.g. '/thank-you'."},"text_visible":{"type":"string","description":"Text that appears only after this exit, e.g. a confirmation message."}},"required":["label"],"additionalProperties":false},"minItems":1,"maxItems":4,"description":"1-4 ways the visit can end. A visitor takes the first exit whose signal matches, or leaves. Give at least one signal per exit: form_contains (most reliable), url_contains or text_visible."},"ads":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"description":"Short name for the ad, e.g. 'Spring carousel'."},"kind":{"type":"string","enum":["image","video","copy"],"description":"What the ad is. asset_id needs image or video."},"description":{"type":"string","minLength":1,"maxLength":6000,"description":"The ad's copy, or what the image or video shows and says. Give this or asset_id."},"asset_id":{"type":"string","format":"uuid","description":"An image or video already uploaded and read through the Read card. The ad is then what that read described (image: its description; video: speech and on-screen text only). Use instead of description."}},"required":["label","kind"],"additionalProperties":false},"maxItems":2,"description":"0-2 ads. Each simulated visitor sees one ad first; with two, they are split across them."},"rewrites":{"type":"object","properties":{"label":{"type":"string","description":"Name for the rewrite arm. Default 'rewrite'."},"ads":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"description":"Optional. Defaults to the original ad's label."},"description":{"type":"string","minLength":1,"maxLength":6000,"description":"The rewritten ad copy or visual description."},"asset_id":{"$ref":"#/properties/ads/items/properties/asset_id","description":"An image or video already uploaded and read through the Read card. The ad is then what that read described (image: its description; video: speech and on-screen text only). Use instead of description."}},"additionalProperties":false},"maxItems":2,"description":"Same order and count as ads. Each replaces that ad's description in the rewrite arm."},"page_copy":{"type":"array","items":{"type":"object","properties":{"find":{"type":"string","minLength":1,"description":"Exact text on the page."},"replace":{"type":"string","description":"Text to show instead."}},"required":["find","replace"],"additionalProperties":false},"maxItems":40,"description":"Text swaps applied to the landing page in the rewrite arm only."}},"additionalProperties":false,"description":"Adds a second arm, 'rewrite', run against the same audience as 'original'. Give ads and/or page_copy."},"audience":{"type":"string","description":"Optional. A synthetic audience: a persona id or name from aetherya_list_audiences, or a short free-text description (e.g. 'first-time SaaS buyers')."},"num_agents":{"type":"integer","minimum":1,"maximum":10,"description":"Simulated visitors per arm. Default 6. Each arm runs this many, and the ads are split round-robin across them. Cost is quoted per arm."},"accept_cost":{"type":"boolean","description":"Leave unset on the first call: nothing starts and the quote comes back. Set true only after the user agrees to the quoted cost."}},"required":["page_url","exits"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"aetherya_verify_prediction","description":"Recompute the hash of a sealed prediction and report whether it still matches the stored one.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"Sealed prediction id."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}],"scan":{"score":79,"grade":"B","scanned_at":"2026-10-27T18:16:52.770Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-27T18:16:52.685Z","components":{"code":{"score":25,"max":25,"notes":["89 source files scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 1547ms"]},"poisoning":{"score":15,"max":15,"notes":["27 tool descriptions checked"]},"auth":{"score":8,"max":15,"notes":["API key sent as a header"]},"maintenance":{"score":3,"max":15,"notes":["no repository listed"]},"identity":{"score":8,"max":10,"notes":["endpoint served from the registry-verified namespace domain"]}},"findings":[{"id":"maint.no-repo","severity":"low","component":"maintenance","title":"No source repository listed"}],"inputs":{"probes":[{"url":"https://mcp.aetherya.ai/mcp","reachable":true,"authRequired":false,"latencyMs":1547,"serverInfo":{"name":"aetherya","version":"1.0.5"}}],"packages":[{"registryType":"npm","identifier":"@aetherya/mcp","version":"1.0.5","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-10-19T12:42:03.200Z","weeklyDownloads":100}],"repo":{"found":false},"icon":{"url":"https://www.aetherya.ai/logos/newlogoaetherya-veritcal-transparent.png","source":"site","width":500,"height":500},"presence":{"stars":null,"forks":null,"downloadsWeek":100,"license":"MIT","lastPushAt":null,"score":18}}}},"grade_history":[],"reviews":[]}