İçeriğe geç
MCP sunucusu

Yazım araçlarımız yapay zeka ajanının içinde

Claude Desktop, Claude Code, Cursor veya başka bir MCP istemcisini bağla. Ajanın bu sitedeki araçlarla metinleri kontrol edebilir, yeniden yazabilir, özetleyebilir ve düzeltebilir.

Sunucu adresi
https://textlume.com/api/mcp

MCP nedir

Model Context Protocol, bir yapay zeka asistanının harici araçları çağırmasını sağlayan açık bir standarttır. MCP sunucumuz aşağıdaki adreste çevrimiçi çalışır. Yalnızca bilgisayarındaki programları başlatabilen istemciler ise küçük sunucu dosyamızı çalıştırır. Her iki yöntem de yalnızca senin anahtarınla bu sitenin API'sini çağırır. Böylece ajanın sitedeki sonuçların aynısını alır.

Ajanın aldığı her sonuç, sayısal değeri, bu değere ilişkin belirsizliği ve kalibrasyon durumunu içerir. Böylece ajan, sonucun ne anlama geldiğini ve hangi durumlarda kullanılmaması gerektiğini açıklayabilir.

  1. Pro planına geç ve kontrol panelinde bir API anahtarı oluştur.
  2. Aşağıdaki yapılandırmada YOUR_API_KEY yerine kendi anahtarını yaz. Sunucu adresini ve anahtarını bu yapılandırmayla istemcine ekle.
  3. Ajanından bir metni kontrol etmesini, yeniden yazmasını, özetlemesini veya düzeltmesini iste.

İstemcinde kur

İstemcini seç. Her sekmede kurulum adımları, kopyalayacağın yapılandırma ve bağlantıyı test etme yöntemi var. Komutlar ve yapılandırmalar tüm dillerde aynıdır.

Claude Code Çevrimiçi bağlanır

  1. API anahtarını, istemcinin çalıştığı ortamda TEXTLUME_API_KEY adlı bir ortam değişkeninde sakla:

    export TEXTLUME_API_KEY="YOUR_API_KEY"
  2. Bunu terminalde çalıştır:

    claude mcp add --transport http textlume https://textlume.com/api/mcp --header "Authorization: Bearer $TEXTLUME_API_KEY"
  3. Ya da bunun yerine şunu .mcp.json dosyasına ekle:

    .mcp.json
    {
      "mcpServers": {
        "textlume": {
          "type": "http",
          "url": "https://textlume.com/api/mcp",
          "headers": {
            "Authorization": "Bearer ${TEXTLUME_API_KEY}"
          }
        }
      }
    }
  4. Çalıştığını kontrol etmek için asistanına şu isteği gönder: "Bu paragrafı Textlume ile kontrol et, aralığı ve güven düzeyini söyle."

API anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.

Yapay zeka asistanları için

Bu kurulumu biri için yapan bir yapay zeka asistanıysan sunucu adresi şu: https://textlume.com/api/mcp. Sunucu, Streamable HTTP üzerinden MCP kullanır ve kullanıcının API anahtarını "Authorization: Bearer <key>" biçiminde bekler. Her istemci için tüm kurulum adımları Markdown biçiminde şu adreste: https://textlume.com/mcp.md.

Kurulumun Markdown sürümü

Claude için hazır bir skill

Bu skill ile Claude hangi aracı ne zaman çağıracağını, yapay zeka dedektörü sonucunu nasıl okuyacağını, planının sınırlarını ve bir çağrı başarısız olunca ne yapacağını bilir. ~/.claude/skills altında textlume adlı bir klasöre SKILL.md olarak kaydet (Claude Code) ya da klasörü ZIP yapıp Ayarlar, Yetenekler, Skills bölümünden yükle (Claude uygulamaları). Skill İngilizcedir ve her dilde çalışır.

SKILL.md dosyasını indir
SKILL.md
---
name: textlume
description: Check text for AI writing, humanize or paraphrase it while keeping its facts, summarize it, and check its grammar with the Textlume MCP tools. Use when the textlume MCP server is connected and the user asks to check whether text reads as AI-written, rewrite AI-sounding text, reword, summarize or proofread.
---

# Textlume writing tools

Textlume gives an agent six tools over MCP: an AI detector, a humanizer, a paraphraser, a summarizer and a grammar checker. Every call goes through the Textlume API with the user's own API key.

## Setup

1. The user needs the Pro plan and an API key from the Textlume dashboard (API section).
2. Put the key in the environment as `TEXTLUME_API_KEY`. Never write the key into a file that gets committed, and never print it.
3. Connect the hosted server. In Claude Code:

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

   In Claude Desktop or another client: server URL `https://textlume.com/api/mcp`, header `Authorization: Bearer <key>`. A client that only runs local servers can start the stdio server from https://textlume.com/mcp/server.mjs with `node server.mjs` and `TEXTLUME_API_KEY` set.
4. Check: list the tools. You should see `detect_text`, `detect_batch`, `humanize_text`, `paraphrase_text`, `summarize_text`, `check_grammar`.

## Which tool to call

### `detect_text` (POST /api/v1/detect)

When: The user asks whether a text reads as AI-written, wants an AI score, or wants to know which sentences read as machine-like.

What it does: Read how likely a text was written by a language model. Returns a figure from 0 to 100 with its margin, our confidence rating (low, medium or high), and a reading for every sentence. Use the figure only when calibrated is true: false means the language has no fitted curve yet.

Arguments:

- `text` (required): The text to check. Too short a text gets no reading (the error says the minimum)
- `language`: Two-letter code. Omitted, the service reads it from the text
- `contentType`: essay, article, email, code

### `detect_batch` (POST /api/v1/detect/batch)

When: The user hands over several texts at once (a folder of essays, a list of posts). One call, one result per item.

What it does: Check many texts in one call. Each item carries its own id and either a reading or an error; one item failing never fails the batch.

Arguments:

- `items` (required)

### `humanize_text` (POST /api/v1/humanize)

When: The user wants AI-sounding text to read more like a person wrote it. Show the before and after reading the tool returns.

What it does: Rewrite machine-sounding text so it reads more like a person wrote it, scored by our own detector before and after. It keeps every fact: a rewrite that changes one is refused and the original sentence is put back. It does not promise to defeat any other detector.

Arguments:

- `text` (required)
- `mode`: natural, formal, simple, academic, creative, shorten or expand
- `tab`: standard, academic, professional, casual
- `strength`: regular, aggressive
- `language`

### `paraphrase_text` (POST /api/v1/paraphrase)

When: The user wants the same meaning in different words (rewording, simplifying, shortening, a different register).

What it does: Reword a text while keeping its meaning. Same guarantees as humanize_text, with the paraphraser modes.

Arguments:

- `text` (required)
- `mode`: standard, fluency, formal, academic, simple, creative, expand or shorten
- `strength`: readable, balanced, strong
- `language`

### `summarize_text` (POST /api/v1/summarize)

When: The user wants the main points of a long text, as key sentences, a paragraph or bullets.

What it does: Summarise a text as key sentences, a paragraph or bullet points.

Arguments:

- `text` (required)
- `mode`: key-sentences, paragraph, bullets
- `length`: short, medium, long

### `check_grammar` (POST /api/v1/grammar)

When: The user wants spelling, grammar and punctuation checked. Apply only the fixes the user accepts.

What it does: Find grammar, spelling and punctuation problems, each with its position, an explanation and replacements.

Arguments:

- `text` (required)
- `language`: For example en-US or de-DE

## Reading a detector result

- Every result has a figure from 0 to 100, a margin, a confidence rating (low, medium, high) and a reading per sentence. Report the figure with its margin and the rating, never a bare percentage.
- If `calibrated` is false, the language has no fitted line yet. Say there is no reading for that language and do not quote the figure as a result.
- The figure says how machine-like the text reads, not what share a machine wrote, and it is not proof of who wrote it. Never call a text "detected". Point to the sentences that read as machine-like instead.
- Texts under 50 words get no reading. Short texts always get a low confidence rating.

## Rewrites

- `humanize_text` and `paraphrase_text` keep names, numbers, quotations and claims. A sentence whose rewrite would change a fact is put back as it was, and the result notes say so. Pass those notes on to the user.
- The before and after figures are Textlume's own detector. Do not promise the user that any other detector will agree.
- Hand the user the rewritten text in full. Do not rewrite it again yourself before showing it.

## Limits

- 60 requests per 60 seconds per key.
- At most 4 detector calls and 2 rewrite or summary calls at the same time per key.
- Up to 20,000 words per call. The detector reads up to 10,000 words (90,000 characters) per text. Split longer texts and say that you did.
- `detect_batch` takes up to 50 items.
- Words count against the monthly words of the user's plan.

## Errors

The tool result carries the API's own message. Act on the code:

- `no_key` or `bad_key` (401): the key is missing or wrong. Ask the user to set `TEXTLUME_API_KEY`. Do not retry.
- `out_of_scope` (403): the key was created without this tool's scope. The user creates a key with that scope on the dashboard.
- `plan_lapsed` (403): the Pro plan is not active. Tell the user, do not retry.
- words used up (402): the response has `available`, the words left this month. Offer to send a shorter text.
- `rate_limited` or `concurrency_limited` (429): wait the seconds in `retry-after`, then retry once. Send batches one after another, not in parallel.
- `text_too_long` (413): split the text and check the parts, and say so.
- `too_short` (422): the text is under 50 words. `not_calibrated` (422): no reading for that language.
- `engine_starting`, `engine_busy`, `engine_unavailable` (503) or `engine_timeout` (504): the service is not available right now. Wait and retry once. Never make up a result.

Ajanından neler isteyebilirsin

Bir isteği kopyalayıp ajanına gönder ve metnini ekle. Ajan, kullanacağı aracı kendi seçer.

Tespit

  • detect_textTek bir metni analiz eder.

    İstek

    Bu denemede yapay zeka kullanılıp kullanılmadığını kontrol et. Sonucun aralığını ve güven düzeyini söyle.

    Dönen sonuç

    0 ile 100 arasında bir değer, hata payı, güven düzeyi ve her cümle için ayrı bir sonuç.

  • detect_batchBirden fazla metni analiz eder.

    İstek

    Bu paragrafları tek tek kontrol et ve sonuç değerine göre en yüksekten en düşüğe sırala.

    Dönen sonuç

    Her metin için kendi kimliği altında bir sonuç veya hata. Bir metinde hata olması diğerlerini etkilemez.

Yeniden yazma

  • humanize_textMetni insanlaştırır ve bilgi doğrulama sonuçlarını sunar.

    İstek

    Bu paragrafı insanlaştır ve olgu kontrollerinde ne bulunduğunu söyle.

    Dönen sonuç

    Yeniden yazılmış metin, aracımızın işlem öncesi ve sonrası yapay zeka tespit sonuçları ve olgusal bilgiyi korumak için eski haline döndürülen her cümleye ilişkin bir not.

  • paraphrase_textMetni yeniden yazar.

    İstek

    Bu giriş bölümünü daha resmi bir dille yeniden yaz.

    Dönen sonuç

    Metni insanlaştırma aracındakiyle aynı olgu kontrollerinden geçen, yeniden yazılmış metin.

  • summarize_textMetni özetler.

    İstek

    Bu raporu madde işaretleriyle özetle.

    Dönen sonuç

    Önemli cümleler, paragraf veya madde listesi biçiminde özet.

Kontrol

  • check_grammarYazım ve dil bilgisini kontrol eder.

    İstek

    Bu e-postanın dil bilgisini kontrol et ve önerilen düzeltmeleri uygula.

    Dönen sonuç

    Her sorunun metindeki yeri, açıklaması ve önerilen düzeltmeler.

Plan ve sınırlar

MCP sunucusu API anahtarını kullanır. Bu nedenle her çağrı, API ile aynı plana, kullanım hakkına ve sınırlara tabidir.

Pro

29,99 USD aylık

50.000
kelimelik aylık insanlaştırma hakkı ve 50.000 kelimelik yeniden yazma hakkı
20.000
tek çağrıda kelime
60
her 60 saniyede anahtar başına istek
4 / 2
anahtar başına eşzamanlı tespit ve yeniden yazma çağrısı
Kontrol panelinden anahtar oluştur

Ek kelime paketleri

  • Yapay zeka tespiti50.000kelimeen düşük 5,99 USD
  • İnsanlaştırma10.000kelimeen düşük 9,99 USD
  • Yeniden yazma10.000kelimeen düşük 9,99 USD
  • Özetleme25.000kelimeen düşük 6,99 USD

API kelime kullanımı nasıl hesaplanır

Her çağrı, sitedekiyle aynı miktarda kelime kullanır. İnsanlaştırma çağrısı Pro planının insanlaştırma hakkından, özetleme çağrısı ise özetleme hakkından düşülür. Bu haklar bittiğinde insanlaştırma ve yeniden yazma çağrıları ek kelime paketlerini kullanır. Yeterli kelime hakkın yoksa çağrı reddedilir ve hiçbir kullanım düşülmez. Her yanıt, kaç kelime kullanıldığını ve kaç kelime kaldığını gösterir.

Tüm kullanım hesaplama kuralları

Pro planına API erişimi dahildir. API çağrıları, sitedeki işlemlerle aynı kelime haklarını kullanır. Tespit çağrısı yapay zeka tespit aracı için ayrılan kelimelerden, insanlaştırma çağrısı metni insanlaştırma aracı için ayrılan kelimelerden, özetleme çağrısı da metin özetleme aracı için ayrılan kelimelerden düşülür. Önce tüketilecek ayrı bir API kotası yoktur. İlgili kelime hakkı bittiğinde yapay zeka tespit aracı, metni insanlaştırma aracı veya metin yeniden yazma aracı çağrıları, sitede olduğu gibi hesabın ek kelime bakiyesini kullanır. Diğer araçlar ek kelime bakiyesini kullanamaz. Kalan kelime hakkı ve ek bakiye birlikte çağrıyı karşılamaya yetmiyorsa çağrı 402 koduyla reddedilir ve kelime hakkından düşülmez. Başarılı her yanıt, recorded değeri false olmadığı sürece, kaç kelime kullanıldığını, hangi haktan düşüldüğünü ve ne kadar kaldığını bildirir. Ele geçirilen bir anahtarın tüm bakiyeyi tek seferde tüketmesini önlemek için hesabın API kullanımı, bakiyeden bağımsız olarak, bir fatura döneminde 250.000 kelimeyle sınırlıdır.

Sınırlar

  • 60her 60 saniyede anahtar başına istek
  • 4anahtar başına eşzamanlı tespit çağrısı
  • 2anahtar başına eşzamanlı insanlaştırma, yeniden yazma veya özetleme çağrısı
  • 50tek toplu istekte metin
  • 20.000tek çağrıda kelime
  • 5hesap başına etkin anahtar
  • Tek metin de göndersen birden fazla metin de göndersen, bir istek toplamda en fazla 20.000 kelime içerebilir.
  • Yapay zeka tespit aracı, tüm planlarda tek seferde en fazla 90.000 karakterlik, yani yaklaşık 10.000 kelimelik bir metni inceler. Daha uzun metinlerde, isteğin kelime limiti aşılmasa bile 413 text_too_long yanıtı döner.
  • İşlem motorları yoğunken sitedeki Pro hesaplarının analiz istekleri API çağrılarından önce işlenir. Bu nedenle API çağrısı sırasını bekleyebilir.

Ajanını bağla

Giriş yap, ardından kontrol panelinden bir anahtar oluştur.

Kontrol panelinden anahtar oluşturAPI neler yaparAPI belgeleri