pangram-mcp
An MCP server for Pangram Labs
AI-generated-text detection. Exposes a single analyze tool that classifies text as
human-written, AI-generated, or AI-assisted — with an overall verdict, per-class
fractions, and a per-segment breakdown.
The API key stays in the server's environment and is sent as the x-api-key header; it
is never returned to the model or logged. Callers pass text and receive a classification
— they never handle the credential.
Install / run
Requires an API key from Pangram Labs:
export PANGRAM_API_KEY="your-key"
uvx pangram-mcp
MCP client config
{
"mcpServers": {
"pangram": {
"command": "uvx",
"args": ["pangram-mcp"],
"env": { "PANGRAM_API_KEY": "your-key" }
}
}
}
Configuration
| Env var | Required | Default | Purpose |
|---|---|---|---|
PANGRAM_API_KEY |
yes | — | Pangram Labs API key. |
PANGRAM_API_BASE |
no | https://text.api.pangram.com/v3 |
Endpoint override. |
PANGRAM_TIMEOUT |
no | 60 |
Request timeout (seconds). |
Tool: analyze
Detect AI-generated text.
| Parameter | Type | Description |
|---|---|---|
text |
string | Text to classify (required). |
public_dashboard_link |
bool | Request a public shareable Pangram dashboard link (default false; only for non-sensitive text). |
The tool takes inline text only — not a file path. Reading files server-side would let a caller exfiltrate any file the process can read, bypassing the harness's permission-gated file tools. Read files with your own tools and pass the text.
Returns structured output: prediction, prediction_short, headline,
fraction_ai / fraction_ai_assisted / fraction_human (0.0–1.0),
num_ai_segments / num_ai_assisted_segments / num_human_segments, a windows
array (per-segment label, ai_assistance_score, confidence, indices), and an
optional dashboard_link.
Development
uv sync --extra dev
uv run pytest
uv run ruff check .
uv run mypy src
License
MIT — see LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pangram_mcp-0.1.4.tar.gz.
File metadata
- Download URL: pangram_mcp-0.1.4.tar.gz
- Upload date:
- Size: 13.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
82cabcaea686efaa672a26b6beb3b1e0673408936768841c93a247475b4dbda6
|
|
| MD5 |
fc335504b81a5687476994fab309ce2c
|
|
| BLAKE2b-256 |
9ff70b840122afb6e5d719a32f783fe36ad9405f177877134660d7160845426e
|
Provenance
The following attestation bundles were made for pangram_mcp-0.1.4.tar.gz:
Publisher:
release.yml on Consiliency/pangram-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pangram_mcp-0.1.4.tar.gz -
Subject digest:
82cabcaea686efaa672a26b6beb3b1e0673408936768841c93a247475b4dbda6 - Sigstore transparency entry: 2371145455
- Sigstore integration time:
-
Permalink:
Consiliency/pangram-mcp@f53c3d9a762102fbe3872ef7c0f615a4214ca9ef -
Branch / Tag:
refs/tags/v0.1.4 - Owner: https://github.com/Consiliency
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@f53c3d9a762102fbe3872ef7c0f615a4214ca9ef -
Trigger Event:
push
-
Statement type:
File details
Details for the file pangram_mcp-0.1.4-py3-none-any.whl.
File metadata
- Download URL: pangram_mcp-0.1.4-py3-none-any.whl
- Upload date:
- Size: 6.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ce4b813417a2980f074eab752f5589697970fa48974b7f25f04e76f74be47724
|
|
| MD5 |
7d16944a6e7cbc1a0742d30cb991bed0
|
|
| BLAKE2b-256 |
3f1408e039986ff9d02ee1c2e0d066482d1ac4c4356176e793789facbe498931
|
Provenance
The following attestation bundles were made for pangram_mcp-0.1.4-py3-none-any.whl:
Publisher:
release.yml on Consiliency/pangram-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pangram_mcp-0.1.4-py3-none-any.whl -
Subject digest:
ce4b813417a2980f074eab752f5589697970fa48974b7f25f04e76f74be47724 - Sigstore transparency entry: 2371145471
- Sigstore integration time:
-
Permalink:
Consiliency/pangram-mcp@f53c3d9a762102fbe3872ef7c0f615a4214ca9ef -
Branch / Tag:
refs/tags/v0.1.4 - Owner: https://github.com/Consiliency
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@f53c3d9a762102fbe3872ef7c0f615a4214ca9ef -
Trigger Event:
push
-
Statement type:
