Developers

An API for how a person writes.

Idiolect AI turns writing someone actually wrote into a Voice Profile other software can read. Score a draft against their voice, fetch their Voice Card by slug, or hand both to an agent over MCP.

Score API

Score any text against a voice.

/ 01

Send a few things the person actually wrote, plus the draft you want to check. You get a 0–100 Voice Match back. Stateless: what you send stays in the request, and nothing is stored. The evidence and the limits are on the Voice Match methodology page.

POST https://idiolect.app/api/score

curl -X POST https://idiolect.app/api/score \
  -H 'content-type: application/json' \
  -d '{
    "region":     ["a few things the person has really written", "..."],
    "candidates": ["the draft you want to score"]
  }'

// → {
//   "scores": [{ "text": "...", "voiceMatch": 84, "cosine": 0.61 }],
//   "metric": { "name": "voice_match", "validated": true,
//               "instrument": "LUAR-MUD authorship embedding (validated)" }
// }

relativeRead the delta against a generic draft; absolutes shift with register.

Voice API

Read a portable Voice Profile.

/ 02

A public, programmatic Voice Card by slug — the style guide any AI can write from. Public‑safe fields only; raw writing is never exposed.

GET https://idiolect.app/api/voice/

curl https://idiolect.app/api/voice/your-slug

// → { "slug", "summary", "genericnessScore",
//     "toneAxes", "signatureMoves", "taboos", "voiceCard" }

MCP

One URL. No config file.

/ 03

Idiolect AI runs as a remote MCP server over Streamable HTTP with OAuth 2.1 — add it as a custom connector in claude.ai or ChatGPT and sign in; nothing to install, no key to issue. An agent gets record_voice_feedback, get_my_voice, create_my_voice, list_writing_profiles, create_writing_profile, add_samples_to_writing_profile, set_current_writing_profile, delete_writing_profile, score_voice, rewrite_in_voice, and draft_in_voice.

Custom connector URL

https://idiolect.app/api/mcp

Reviewed and published in Claude’s connector directory — that page opens inside claude.ai; the URL above works anywhere.

Full setup for each app, every tool’s inputs, and troubleshooting: the MCP connector docs.

Voice Card

Or just paste it in.

/ 04

No integration needed — every Voice Profile renders to a self‑contained Voice Card you drop into a ChatGPT Custom GPT or the top of any chat. The model writes as the person from there.

Start here

Every endpoint needs a voice to read.

Make your own Voice Profile first — it is the fastest way to see what the API returns.

Create my Voice Profile

Building this for a team, or at volume? Tell us what you need.