Connecting Loquiry to AI tools (MCP)

Loquiry speaks the Model Context Protocol, the open standard AI assistants like Claude use to talk to outside tools. Today one connection exists — AI participation — and an authoring connector is upcoming (see the end of this page).

AI participation: participants contribute through their assistant

A participant who works in an MCP-capable client (Claude Code, or any client that reads .mcp.json) can be offered your survey in chat and contribute without opening a browser form.

How it fits together:

You mint a key. Open your survey's Settings page and find the MCP keys panel. Mint a key (give it a label — "pilot group", "team A"). The key is shown once, together with a ready-made .mcp.json snippet; copy both before leaving the page. Treat keys like participation links: share privately, with the people you want. Keys are per-survey and revocable from the same panel.
The participant installs the snippet. They paste it into their client's .mcp.json:
```
{
  "mcpServers": {
    "loquiry": {
      "command": "loquiry-mcp",
      "env": {
        "MVP_MCP_KEY": "<the minted key>",
        "MVP_MCP_API": "https://study.loquiry.io"
      }
    }
  }
}
```
loquiry-mcp is a small binary the operator distributes; it talks only to the participation server, authenticated by the key.
You write the invocation sentence. The Settings page's AI participation field tells the assistant when to suggest your survey — it becomes part of the tool description the model reads. Be concrete: "When the user mentions a difficult conversation they had at work."
The participant contributes in chat. The assistant collects answers conversationally and submits them to your survey; drafts captured in chat can also be resumed in the browser form.

What the key can and cannot do: it is scoped to one survey's participation surface — it cannot read other participants' answers, touch your account, or edit the survey.

Connect from Claude or ChatGPT: the authoring connector

Loquiry serves a remote MCP connector that lets your AI assistant help create surveys on your account — draft pages and inputs, set name and language, publish, and hand you the participation link. Participation stays out of its scope (that is what per-survey keys above are for).

Connector URL: https://loquiry.io/mcp

Add it as a custom connector in Claude (Settings → Connectors) or as an app in ChatGPT and open the connection: you will be sent to Loquiry to sign in or create your account, then asked to allow the access ("create and edit surveys on your account"). That's it — the assistant now operates your account through these tools:

Tool	What it does
`list_studies`	Your surveys with their `participant_id` handles
`create_study`	New draft survey (name, participant-chrome language)
`get_study`	Full survey config as YAML
`add_page` / `add_element` / `update_element` / `remove_element`	Build the survey; element configs follow the input reference
`set_study_settings`	Rename, switch language
`publish_study`	Validate + go live, returns the participation link
`get_participation_link`	The public URL to share

Notes:

The connector can only add what your account could add in the editor.
Access is a standard OAuth 2.1 grant (PKCE, no password shared with the AI tool). Revoke it anytime under Account → Connected apps; the connector then has to re-authorize.
Tokens are scoped to survey authoring. The connector cannot read submissions, manage your account, or touch other accounts' surveys.