Textlume writing tools in your AI agent

Claude Code Connects to the hosted server

1. Store your API key in an environment variable named TEXTLUME_API_KEY on the machine where the client runs:

   Copy

   export TEXTLUME_API_KEY="YOUR_API_KEY"

2. Run this command in a terminal:

   Copy

   claude mcp add --transport http textlume https://textlume.com/api/mcp --header "Authorization: Bearer $TEXTLUME_API_KEY"

3. Or add it to .mcp.json instead:

   .mcp.jsonCopy

   {
     "mcpServers": {
       "textlume": {
         "type": "http",
         "url": "https://textlume.com/api/mcp",
         "headers": {
           "Authorization": "Bearer ${TEXTLUME_API_KEY}"
         }
       }
     }
   }

4. To test the connection, ask your assistant: "Use Textlume to check this paragraph and give me the range and the confidence rating."

You will find your API key on your dashboard, under API. Keep keys out of shared files and repositories.

Claude Desktop Uses the server file

1. Download the server file and remember where you saved it. Node.js is required.

   Download the server file

2. In the app, go to Settings > Developer > Edit Config.

3. Add the following to claude_desktop_config.json:

   claude_desktop_config.jsonCopy

   {
     "mcpServers": {
       "textlume": {
         "command": "node",
         "args": [
           "/path/to/server.mjs"
         ],
         "env": {
           "TEXTLUME_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }

4. Quit Claude Desktop and open it again so it picks up the server.

5. To test the connection, ask your assistant: "Use Textlume to check this paragraph and give me the range and the confidence rating."

You will find your API key on your dashboard, under API. Keep keys out of shared files and repositories.

Claude (claude.ai) Coming soon

Connecting claude.ai by signing in to your Textlume account is coming soon. For now, the same tools already work in Claude Desktop through the server file, and in Claude Code. Their tabs have the setup.

Claude DesktopClaude Code

1. Only if your organization can set request headers on custom connectors: add the address together with this header.

   Copy

   URL: https://textlume.com/api/mcp
   Authorization: Bearer YOUR_API_KEY

ChatGPT Coming soon

Connecting ChatGPT by signing in to your Textlume account is coming soon. For now, the same tools already work in Codex and Claude Code. Their tabs have the setup.

CodexClaude Code

Codex Connects to the hosted server

1. Store your API key in an environment variable named TEXTLUME_API_KEY on the machine where the client runs:

   Copy

   export TEXTLUME_API_KEY="YOUR_API_KEY"

2. Run this command in a terminal:

   Copy

   codex mcp add textlume --url https://textlume.com/api/mcp --bearer-token-env-var TEXTLUME_API_KEY

3. Or add it to ~/.codex/config.toml instead:

   ~/.codex/config.tomlCopy

   [mcp_servers.textlume]
   url = "https://textlume.com/api/mcp"
   bearer_token_env_var = "TEXTLUME_API_KEY"

4. In the app, go to MCP servers > Add server > Streamable HTTP.

5. To test the connection, ask your assistant: "Use Textlume to check this paragraph and give me the range and the confidence rating."

You will find your API key on your dashboard, under API. Keep keys out of shared files and repositories.

Cursor Connects to the hosted server

1. Store your API key in an environment variable named TEXTLUME_API_KEY on the machine where the client runs:

   Copy

   export TEXTLUME_API_KEY="YOUR_API_KEY"

2. Add the following to ~/.cursor/mcp.json:

   ~/.cursor/mcp.jsonCopy

   {
     "mcpServers": {
       "textlume": {
         "url": "https://textlume.com/api/mcp",
         "headers": {
           "Authorization": "Bearer ${env:TEXTLUME_API_KEY}"
         }
       }
     }
   }

3. To test the connection, ask your assistant: "Use Textlume to check this paragraph and give me the range and the confidence rating."

You will find your API key on your dashboard, under API. Keep keys out of shared files and repositories.

VS Code (Copilot) Connects to the hosted server

1. Add the following to .vscode/mcp.json:

   .vscode/mcp.jsonCopy

   {
     "inputs": [
       {
         "type": "promptString",
         "id": "textlume-key",
         "description": "Textlume API key",
         "password": true
       }
     ],
     "servers": {
       "textlume": {
         "type": "http",
         "url": "https://textlume.com/api/mcp",
         "headers": {
           "Authorization": "Bearer ${input:textlume-key}"
         }
       }
     }
   }

2. The first time the server starts, VS Code asks for your key and stores it.

3. To test the connection, ask your assistant: "Use Textlume to check this paragraph and give me the range and the confidence rating."

You will find your API key on your dashboard, under API. Keep keys out of shared files and repositories.

Windsurf Connects to the hosted server

1. Store your API key in an environment variable named TEXTLUME_API_KEY on the machine where the client runs:

   Copy

   export TEXTLUME_API_KEY="YOUR_API_KEY"

2. In the app, go to Cascade > ... > Open MCP config file.

3. Add the following to mcp_config.json:

   mcp_config.jsonCopy

   {
     "mcpServers": {
       "textlume": {
         "serverUrl": "https://textlume.com/api/mcp",
         "headers": {
           "Authorization": "Bearer ${env:TEXTLUME_API_KEY}"
         }
       }
     }
   }

4. Quit Windsurf and open it again so it picks up the server.

5. To test the connection, ask your assistant: "Use Textlume to check this paragraph and give me the range and the confidence rating."

You will find your API key on your dashboard, under API. Keep keys out of shared files and repositories.

Gemini CLI Connects to the hosted server

1. Store your API key in an environment variable named TEXTLUME_API_KEY on the machine where the client runs:

   Copy

   export TEXTLUME_API_KEY="YOUR_API_KEY"

2. Run this command in a terminal:

   Copy

   gemini mcp add --transport http --header "Authorization: Bearer $TEXTLUME_API_KEY" textlume https://textlume.com/api/mcp

3. Or add it to ~/.gemini/settings.json instead:

   ~/.gemini/settings.jsonCopy

   {
     "mcpServers": {
       "textlume": {
         "httpUrl": "https://textlume.com/api/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_API_KEY"
         }
       }
     }
   }

4. To test the connection, ask your assistant: "Use Textlume to check this paragraph and give me the range and the confidence rating."

You will find your API key on your dashboard, under API. Keep keys out of shared files and repositories.

Other clients Hosted server, bridge or server file

1. A client that connects to remote MCP servers over HTTP only needs these two values:

   Copy

   URL: https://textlume.com/api/mcp
   Authorization: Bearer YOUR_API_KEY

2. A client that can only launch local servers can still reach the address through the open-source mcp-remote bridge, which requires Node.js:

   Copy

   {
     "mcpServers": {
       "textlume": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://textlume.com/api/mcp",
           "--header",
           "Authorization:${AUTH_HEADER}",
           "--transport",
           "http-only"
         ],
         "env": {
           "AUTH_HEADER": "Bearer YOUR_API_KEY"
         }
       }
     }
   }

3. Or run the server file directly:

   Copy

   TEXTLUME_API_KEY="YOUR_API_KEY" node /path/to/server.mjs

   Download the server file

You will find your API key on your dashboard, under API. Keep keys out of shared files and repositories.