Log inSubmit server
Idiolect AI logo

Idiolect AI

Loads an Idiolect Voice Card into MCP-compatible AI clients for voice retrieval, scoring, rewriting, and drafting.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Idiolect AI

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "idiolect-ai-2": {
      "command": "npx",
      "args": [
        "-y",
        "idiolect-mcp"
      ],
      "env": {
        "IDIOLECT_API_KEY": "YOUR_VALUE_HERE",
        "IDIOLECT_SLUG": "YOUR_VALUE_HERE",
        "IDIOLECT_BASE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 6 tools correctly (6d ago).

Overview

Idiolect AI MCP server connects MCP-compatible AI clients to an Idiolect AI Voice Card. It provides tools to retrieve a voice, create an account-based Voice Profile, score writing, rewrite prose, and draft from a brief. Run it through the hosted Streamable HTTP endpoint with OAuth 2.1, or use the stdio package with an API key or voice slug. Reach for it when an agent needs to produce or evaluate text against a specific personal writing style.

Use cases

  • Retrieve a personal Voice Card before generating text
  • Score a draft against a configured writing voice
  • Rewrite prose using an account-based Voice Profile
  • Draft content from a brief in a personal voice

Key features

  • Voice Card retrieval
  • Account-based Voice Profile creation
  • Voice similarity scoring
  • Voice-preserving rewriting
  • Brief-to-draft generation
  • Hosted Streamable HTTP and local stdio modes

Tools6

What Idiolect AI lets your agent do. Expand a tool for its parameters.

Verified live~6.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

23/23 checks healthy over the last 91d

What it can do

From the 6 tools this server returned when we ran it; 6 declare their own safety hints.

Can delete or modify data · 1Makes network requests · 2Read-only tools · 5
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age154 days
Maintainers1

Observed 2026-11-02 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · idiolect-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.3kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.

How Idiolect AI works

What Idiolect AI MCP server does

Idiolect AI MCP server gives an MCP-compatible AI access to a personal writing voice represented by an Idiolect AI Voice Card or Voice Profile. The available tools cover five operations: retrieving voice guidance, creating a private profile from approved writing, measuring how closely text matches a voice, rewriting existing prose, and generating a draft from a brief.

The server supports two local configuration patterns. Account mode uses an Idiolect API key and resolves the user’s Voice Profile through the account. Slug mode uses a voice slug obtained from an Idiolect result URL. Slug mode supports voice retrieval and stateless scoring with locally configured samples, while profile creation, rewriting, and drafting are account-mode tools.

How it works

For the hosted option, an MCP client connects to https://idiolect.app/api/mcp using Streamable HTTP and OAuth 2.1. The repository also provides a stdio server that clients can launch with npx -y idiolect-mcp; this option is intended for clients without remote MCP support or for users who want to run the process themselves.

get_my_voice returns the Voice Card for use during generation. If an account does not yet have a Voice Profile, setup can remain in the conversation: the user can provide three to five writing examples or complete the short guided interview. Profile creation occurs only after the user explicitly requests it from supplied or approved evidence.

create_my_voice sends approved writing to the Idiolect AI account as private Voice Profile evidence and does not return that evidence through the tool. Retries can use an idempotency key. In slug mode, configured samples are used only for stateless scoring and are not stored.

Setup and configuration

Account mode requires IDIOLECT_API_KEY. A typical stdio configuration launches the package with npx and passes the key through the server environment. Slug mode instead uses IDIOLECT_SLUG; the slug is the value in an Idiolect URL such as idiolect.app/v/<slug>. The slug may also be supplied to get_my_voice per call.

Set IDIOLECT_BASE when the server should use a self-hosted instance rather than the default https://idiolect.app. The repository includes a Docker image for starting and inspecting the stdio server. Docker must be run interactively with -i; the transport is not a network port.

Tools and capabilities

  • get_my_voice: returns the configured Voice Card.
  • create_my_voice: creates an account-based private Voice Profile from approved writing.
  • score_voice: evaluates text against the configured voice; account mode uses the API key, while slug mode uses local samples.
  • rewrite_in_voice: rewrites drafted prose in the account’s voice.
  • draft_in_voice: creates prose from a brief in the account’s voice.

Limitations and notes

The account-only operations are create_my_voice, rewrite_in_voice, and draft_in_voice. The stdio process needs either an API key or a slug for the tools that require voice data. Docker is supplied mainly as a reference image for startup and tool introspection; tools/list works without credentials, but the tools themselves require a key or slug. The project is MIT licensed.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Idiolect AI

Idiolect AI is an MCP server that connects MCP-compatible AI clients to an Idiolect AI Voice Card and provides tools for retrieving voice, creating a profile, scoring text, rewriting drafts, and drafting from briefs. It supports account-key and slug-based modes, with some tools limited to account mode.

Run it with `npx -y idiolect-mcp` in an MCP client’s stdio configuration. Set `IDIOLECT_API_KEY` for account mode or `IDIOLECT_SLUG` for slug mode. You can also connect to the hosted endpoint at `https://idiolect.app/api/mcp` without installing the package.

Yes, Idiolect AI works with Claude Desktop through its hosted MCP connector or the stdio package. The README names Claude Desktop as a compatible MCP client; use the client-specific setup instructions at the Idiolect developer documentation.

Account mode requires `IDIOLECT_API_KEY`, and it enables Voice Profile creation, account-based scoring, rewriting, and drafting. Slug mode can provide voice retrieval and stateless scoring using `IDIOLECT_SLUG`, but the account-only tools are unavailable there.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewIdiolect AI AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/idiolect-ai-2?style=directory)](https://allmcps.com/mcp/idiolect-ai-2)
HTML Embed
<a href="https://allmcps.com/mcp/idiolect-ai-2"><img src="https://allmcps.com/api/badge/idiolect-ai-2?style=directory" alt="Idiolect AI on AllMCPs" /></a>