SupWriter logoSupWriter

Humanize AI text inside VS Code

MCP is built into VS Code's Copilot agent mode (1.102+), so SupWriter's tools work right in your editor. Humanize content and check grammar in the file you're already in.

https://supwriter.com/api/mcpOAuth sign-in · uses your plan credits

Two ways to connect

Sign in with OAuth, or use a Direct API key if you'd rather skip the sign-in screen. Either way, calls use your existing plan credits.

Recommended

Sign in with OAuth

  1. 1

    Add an MCP server

    Run "MCP: Add Server" from the Command Palette (or create a .vscode/mcp.json file). Choose HTTP when prompted.

  2. 2

    Point it at SupWriter

    Under the top-level "servers" key, add "supwriter" with "type": "http" and "url": "https://supwriter.com/api/mcp". Approve the trust prompt to start it.

  3. 3

    Sign in

    On first use VS Code runs the OAuth flow automatically — click Allow and sign in to SupWriter. No client ID or secret to enter.

  4. 4

    Use it

    Open Chat, switch the dropdown to Agent mode, and ask: "Humanize the draft README." (MCP tools only appear in Agent mode.)

Alternative

Connect with a Direct API key

For clients that take an Authorization header (and headless agents). Requires a Pro or Ultra plan.

  1. 1

    Create an API key

    In SupWriter, open Settings → API & MCP → API keys and create a key. API access requires a Pro or Ultra plan.

  2. 2

    Add the server with a header

    Point your client at https://supwriter.com/api/mcp and send the key as an "Authorization: Bearer" header — no sign-in screen needed.

  3. 3

    Start writing

    The key inherits your plan credits. Rotate or revoke it any time from Settings → API & MCP.

Example client config
# Cursor / Claude Code — JSON, "mcpServers" key (~/.cursor/mcp.json)
{
  "mcpServers": {
    "supwriter": {
      "url": "https://supwriter.com/api/mcp",
      "headers": { "Authorization": "Bearer sw_live_your_key" }
    }
  }
}

# VS Code — JSON, "servers" key, type "http" (.vscode/mcp.json)
{
  "servers": {
    "supwriter": {
      "type": "http",
      "url": "https://supwriter.com/api/mcp",
      "headers": { "Authorization": "Bearer sw_live_your_key" }
    }
  }
}

# Codex — TOML (~/.codex/config.toml). Codex sends the env var's VALUE as the
# bearer token, so export SUPWRITER_TOKEN=sw_live_your_key first.
[mcp_servers.supwriter]
url = "https://supwriter.com/api/mcp"
bearer_token_env_var = "SUPWRITER_TOKEN"

# Claude Code — one command
claude mcp add --transport http supwriter https://supwriter.com/api/mcp \
  --header "Authorization: Bearer sw_live_your_key"
Create an API key

Test it

Once connected, ask VS Code to use a tool. A few prompts that work well:

  • “Humanize this so it reads naturally: <your text>”
  • “Paraphrase this in a casual tone: <your text>”
  • “Grammar-check and fix this paragraph: <your text>”
  • “Run an AI-detection check on the text above and tell me which sentences look AI-written.”

FAQ

Does connecting cost anything extra?

No separate MCP fee — calls draw on the word credits already in your SupWriter plan (one credit per word). AI detection is metered over MCP too (one credit per word analyzed), the same as the REST API; it's free only inside the web app.

Is my account safe?

Yes. You authorize either through SupWriter's own OAuth sign-in — approving a consent screen that lists exactly what the client can do — or with a scoped API key. OAuth tokens are short-lived, and keys can be rotated or revoked any time from Settings → API & MCP.

Which tools become available?

Four: humanize, paraphrase, grammar-check, and AI detection — the same engines that power the SupWriter editor.

Want the full walkthrough with screenshots?

Read the VS Code setup guide