AYA Developers

Calm API, MCP, install, and console surfaces for working with AYA’s digital twin system.


Developer Platform

ChatGPT

Public view

Install AYA in ChatGPT

Add AYA to ChatGPT

AYA isn’t in ChatGPT’s app directory yet, so you add it once as a custom app. You only need AYA’s server address.

ChatGPT · custom app (beta)
Workspace-scoped OAuth
Phase 1 toolset

What AYA does

A narrow connector surface designed for repeatable research tasks

AYA stays intentionally focused in the public rollout so people and models know when to call it.

What the connector can do
Use AYA when the task needs audience evidence
When not to call it

Install

Install flow

These steps keep the install tied to one user, one workspace, and one canonical AYA installation record.

Step 01

Turn on Developer mode in ChatGPT

On ChatGPT web, open Settings → Apps → Advanced settings and switch on Developer mode. On a Business or Enterprise workspace, an admin may need to allow custom apps first.

Step 02

Create the app

In Settings → Apps, choose Create. Name it Ask Your Audience, paste https://mcp.askyouraudience.ai/mcp, set Authentication to OAuth and choose Create.

Step 03

Sign in and allow access

ChatGPT opens AYA. Sign in and choose Allow access. Open a new chat, select AYA and ask: “Which audiences do I have in AYA?”

Example prompts

Prompts that work well

Good prompts tell the model what decision is being made, which audience it cares about, and what kind of recommendation should come back.

Launch decision

Prepare a Concept Test for this landing-page concept with my UK parents audience. Show me the participants and cost, and wait for my approval before running it.

Message refinement

Test this headline with my European B2B marketers audience. What will make them lean in, and what will make them tune out?

Qualitative follow-up

Prepare a focus group with six people from my saved audience about the strongest objections to this offer. Show me the questions and cost first.

Read the findings

Explain the findings from my latest completed AYA study and link the full report.

Only use AYA when necessary

If this question doesn’t need audience research, answer directly. If it does, prepare an AYA study and wait for my approval before running it.

Metadata

Public connector guidance

Use this as the operator-facing reminder for how the connector should behave.

markdown

# AYA for ChatGPT
Use AYA when:- the user wants an audience-backed read on a concept, message, ad or positioning choice- the user asks about their AYA audiences or completed AYA studies
Tools:- search_audiences, get_audience_details: find and review existing audiences- prepare_concept_test, run_concept_test: quote, then run an approved Concept Test- prepare_/run_ image_ad, focus_group, interview: where enabled for the account- get_study_status, get_study_results: follow a run and read its findings- search_studies, get_saved_study: read saved research, with optional consent
Do not use AYA when:- the task is ordinary writing, editing, coding, image generation or factual Q&A- the user asks to buy credits or upgrade; purchases are not available here
Preferred behavior:- show the exact brief, participants and token cost, then wait for explicit approval before any run tool- describe results as simulated digital-twin research, not a representative survey

Support

Troubleshooting and support

If the install looks healthy but the connector is still failing, check the auth state and reconnect from the same workspace.

AYA says it can’t connect to this app

Delete the AYA app in ChatGPT and create it again with only the server address and OAuth, leaving the advanced OAuth settings empty.

I can’t find Create or Developer mode

Your ChatGPT plan or workspace has to allow custom apps. On a Business or Enterprise workspace, ask an admin to enable them.

Connections doesn’t show Connected

It changes to Connected after ChatGPT first opens AYA in a chat. Start a new chat, select AYA, send a prompt, then choose Check connection.