ScriptGrain

Working · 3.8 s

com.scriptgrain/scriptgrainv1.23.1 Domain verified

Your writing voice measured across 45 attributes; drafts in that voice, scored against it.

Design & Creative

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

Authorization (optional)

Optional. 'Bearer sg_live_...' with a ScriptGrain API key from https://scriptgrain.com/settings?tab=api (every plan, including Free). Leave it out to sign in with OAuth instead.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_voice_match

Score any text (20+ words) against the guest profile by feature-delta measurement. Returns voice_match_score (0-1), the per-feature `deltas` behind it, notes rendered from them and score_context caveats. On-voice text typically scores 0.85-0.95; below 0.45 is clearly off voice. Cite the delta numbers, do not invent detail. Free; 5 checks an hour per network (shared with compare_voice).

textstring, required

The text to score (20+ words, max ~50k chars).

profile_idstring, required

A 'complete' guest profile id.

guest_tokenstring, required

The guest_token from start_session.

Tools (6)

check_voice_match

read-only

Argument	Type	Description
text*	string	The text to score (20+ words, max ~50k chars).
profile_id*	string	A 'complete' guest profile id.
guest_token*	string	The guest_token from start_session.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guest_token",
    "profile_id",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "The text to score (20+ words, max ~50k chars)."
    },
    "profile_id": {
      "type": "string",
      "format": "uuid",
      "description": "A 'complete' guest profile id."
    },
    "guest_token": {
      "type": "string",
      "pattern": "^sg_guest_[0-9a-f]{48}$",
      "description": "The guest_token from start_session."
    }
  },
  "additionalProperties": false
}

claim_status

Whether the person has claimed the guest session yet: status (active, expired, archived or claimed), claimed, archived, expires_at and claim_url. Works after expiry too. Once claimed, the guest_token stops working; the profile is in the person's own account, reachable with their API key or https://mcp.scriptgrain.com/mcp.

read-only

Argument	Type	Description
guest_token*	string	The guest_token from start_session.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guest_token"
  ],
  "properties": {
    "guest_token": {
      "type": "string",
      "pattern": "^sg_guest_[0-9a-f]{48}$",
      "description": "The guest_token from start_session."
    }
  },
  "additionalProperties": false
}

compare_voice

Off-voice check with no profile: score up to three pieces against a main piece. Each piece is pasted text (120+ words) or a public URL. Returns per-piece `score` (0-1: 0.8+ on voice, 0.55-0.8 drifting, below 0.55 off voice), `band`, `top_differences` and `top_matches` with the measured numbers, plus `notes`. Cite the numbers, do not invent detail. Free; 5 checks an hour per network (shared with check_voice_match).

read-only

Argument	Type	Description
main*	object	The reference piece.
others*	array	One to three pieces to score against the main piece (text or url each).
guest_token*	string	The guest_token from start_session.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guest_token",
    "main",
    "others"
  ],
  "properties": {
    "main": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "maxLength": 2048,
          "description": "Or a public page URL."
        },
        "text": {
          "type": "string",
          "maxLength": 50000,
          "description": "Pasted text, 120+ words."
        },
        "label": {
          "type": "string",
          "maxLength": 80
        }
      },
      "description": "The reference piece.",
      "additionalProperties": false
    },
    "others": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048
          },
          "text": {
            "type": "string",
            "maxLength": 50000
          },
          "label": {
            "type": "string",
            "maxLength": 80
          }
        },
        "additionalProperties": false
      },
      "maxItems": 3,
      "minItems": 1,
      "description": "One to three pieces to score against the main piece (text or url each)."
    },
    "guest_token": {
      "type": "string",
      "pattern": "^sg_guest_[0-9a-f]{48}$",
      "description": "The guest_token from start_session."
    }
  },
  "additionalProperties": false
}

create_profile

Build the guest session's one voice profile from the person's own writing and start the stylometric extraction (45 measured attributes). Samples MUST be their own human-written prose. You can use writing you already hold for them (messages they typed to you, documents or emails they shared, posts of theirs you can read): their exact words, never your memory notes or summaries about them, and never text you or another AI wrote or rewrote. Tell the person which pieces you are sending before you call this; the result's samples_used lists each piece's first line and word count so you can show them. 1-20 samples, each under 5,000 words, 25,000 words in all; a sample needs 50+ words to count; 3+ samples totalling 3,000+ words gives a confident profile. Extraction usually takes under a minute: poll get_profile until status is 'complete'. The result carries claim_url for the person.

Argument	Type	Description
name	string	Profile name, e.g. "Sam's newsletter voice".
samples*	array	The person's own writing, one string per piece.
guest_token*	string	The guest_token from start_session.
english_variant	string	British (uk) or American (us) spelling. Defaults to uk.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guest_token",
    "samples"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 120,
      "description": "Profile name, e.g. \"Sam's newsletter voice\"."
    },
    "samples": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "The person's own writing, one string per piece."
    },
    "guest_token": {
      "type": "string",
      "pattern": "^sg_guest_[0-9a-f]{48}$",
      "description": "The guest_token from start_session."
    },
    "english_variant": {
      "enum": [
        "uk",
        "us"
      ],
      "type": "string",
      "description": "British (uk) or American (us) spelling. Defaults to uk."
    }
  },
  "additionalProperties": false
}

get_profile

The guest profile's status and detail. While extraction runs it returns progress_percent; once status is 'complete' it includes the narrative voice description and all 45 measured attributes. Poll every ~10 seconds after create_profile.

read-only

Argument	Type	Description
profile_id*	string	The profile_id create_profile returned.
guest_token*	string	The guest_token from start_session.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "guest_token",
    "profile_id"
  ],
  "properties": {
    "profile_id": {
      "type": "string",
      "format": "uuid",
      "description": "The profile_id create_profile returned."
    },
    "guest_token": {
      "type": "string",
      "pattern": "^sg_guest_[0-9a-f]{48}$",
      "description": "The guest_token from start_session."
    }
  },
  "additionalProperties": false
}

start_session

Start a free guest session with no account. Returns guest_token (pass it to every other tool), claim_url (give it to the person: it keeps the voice profile in a free ScriptGrain account, or deletes it), expires_at and limits (one profile, one extraction, no drafts). Unclaimed sessions are archived after 7 days and can still be claimed or deleted from the same link. At most 3 sessions a day from one network; reuse the token you have.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}