Kaidn-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KAIDN_API_KEY | Yes | Your secret key. Environment only — never a flag, never a tool argument. | |
| KAIDN_API_URL | No | API base URL | https://api.kaidn.io |
| KAIDN_MCP_HOST | No | HTTP bind address | 127.0.0.1 |
| KAIDN_MCP_PORT | No | HTTP port | 8765 |
| KAIDN_MCP_TRANSPORT | No | Serve Streamable HTTP | stdio |
| KAIDN_MCP_HTTP_TOKEN | No | Require Authorization: Bearer on HTTP | |
| KAIDN_MCP_ALLOW_WRITES | No | Register the mutating tools | off |
| KAIDN_MCP_MAX_QUOTA_CALLS | No | Quota ceiling per process | 100 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| check_emailA | Enrichment and in-network reputation for one email address: disposable/ throwaway domain, deliverability, fraud score, plus how often the address has been seen abusing other operators. Also returns |
| check_ipA | Enrichment and in-network reputation for one IP: proxy/VPN/Tor, datacenter ASN, geo, fraud score, and cross-operator abuse history. Consumes one row of monthly quota. |
| check_phoneA | Validity, line type, carrier and fraud score for one phone number. Consumes one row of monthly quota. |
| list_eventsA | Scored events for this tenant, newest first. Free — does not consume quota. Filter by verdict or event type to narrow an investigation. |
| get_statsA | Aggregate view over a rolling window: totals by verdict, average score and the most common reasons. Free — does not consume quota. Start here to see what changed before drilling into individual events. |
| get_configA | This tenant's weight and threshold overrides plus the effective merged engine config. Free. Useful for explaining why a score landed where it did. |
| explain_eventA | The 'why was this blocked?' tool. Returns the event with every check that fired, its weight, and the raw evidence behind it, so the reasoning can be narrated with receipts rather than guessed at. Free. |
| investigate_entityA | One call for what a fraud analyst actually wants. Returns enrichment for the entity, its reputation across the CROSS-OPERATOR abuse network (whether this email, IP or device has already burned other businesses, not just yours), and every recent event it appears in — which is how you get from one suspicious signup to the whole ring of accounts sharing its device, IP or inbox. Supply exactly one of email, ip or device_id. Enrichment consumes one row of monthly quota (device_id lookups are free). |
| triage_queueA | Every event sitting on the 'review' verdict, sorted by score descending — the daily triage job. Free. |
| score_eventA | Run an event through the scoring engine and get {score, verdict, reasons, checks}. When the event carries an email, the response also has an |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose: check_email/check_ip/check_phone target different entity types, the read-only analytics tools (list_events, get_stats, get_config, explain_event, triage_queue) each serve a unique function, investigate_entity combines enrichment and history, and score_event is the only action that records an event. No two tools are easily confused.
All tool names follow a consistent verb_noun snake_case pattern (check_email, list_events, get_config, score_event, etc.). The verbs (check, list, get, explain, investigate, triage, score) clearly indicate the action, and the nouns (email, events, stats, config, entity, queue) indicate the resource.
10 tools is well within the ideal range for a fraud investigation MCP. Each tool covers a distinct need — enrichment, event browsing, stats, config, explanation, investigation, triage, and scoring — without unnecessary redundancy or bloat.
The tool set covers the full investigation lifecycle: enrichment for email/IP/phone/device, listing and triaging events, understanding scores via stats and config, explaining individual verdicts, investigating entity history, and testing new events. There are no obvious missing operations for the stated purpose.