/install email-header-analyser
Overview
The Email Header Analyser API provides deep inspection and forensic analysis of email message headers. Security professionals, incident responders, and email administrators use this tool to identify spoofing attempts, trace message routing, validate authentication protocols (SPF, DKIM, DMARC), and detect malicious headers.
Email headers contain critical metadata that reveals the true origin of messages, intermediate mail servers, and authentication status. This API parses raw headers and extracts actionable intelligence for phishing investigations, compliance audits, and email security operations.
Ideal users include SOC analysts, email security teams, incident response professionals, forensic investigators, and organizations requiring email authentication verification and threat intelligence capabilities.
Usage
Sample Request
{
"header": "Received: from mail.example.com (mail.example.com [192.0.2.1]) by mx.targetdomain.com with SMTP id abc123; Wed, 15 Jan 2025 10:30:45 +0000\
From: [email protected]\
To: [email protected]\
Subject: Security Analysis\
Authentication-Results: targetdomain.com; spf=pass [email protected]; dkim=pass header.d=example.com; dmarc=pass\
Return-Path: \[email protected]>\
Date: Wed, 15 Jan 2025 10:30:45 +0000"
}
Sample Response
{
"sender_ip": "192.0.2.1",
"sender_domain": "mail.example.com",
"from_address": "[email protected]",
"to_address": "[email protected]",
"received_servers": [
{
"hostname": "mail.example.com",
"ip": "192.0.2.1",
"timestamp": "2025-01-15T10:30:45Z"
},
{
"hostname": "mx.targetdomain.com",
"ip": null,
"timestamp": null
}
],
"authentication": {
"spf": "pass",
"dkim": "pass",
"dmarc": "pass"
},
"subject": "Security Analysis",
"date": "2025-01-15T10:30:45Z",
"return_path": "[email protected]",
"suspicious_indicators": []
}
Endpoints
POST /analyze-header
Analyzes a raw email header to extract authentication, routing, and security metadata.
Method: POST
Path: /analyze-header
Request Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| header | string | Yes | Raw email header text containing one or more Received headers, authentication headers, and message metadata. |
Response Schema:
The response contains extracted header analysis including:
| Field | Type | Description |
|---|---|---|
| sender_ip | string | IP address of the originating mail server. |
| sender_domain | string | Hostname of the originating mail server. |
| from_address | string | Email address in the From header. |
| to_address | string | Email address in the To header. |
| received_servers | array | List of mail servers in the routing path with hostname, IP, and timestamp. |
| authentication | object | Authentication protocol results (spf, dkim, dmarc status). |
| subject | string | Email subject line. |
| date | string | Message date in ISO 8601 format. |
| return_path | string | Return-Path header value. |
| suspicious_indicators | array | List of detected anomalies or security concerns. |
Status Codes:
- 200: Successful analysis returned.
- 422: Validation error—header field missing or invalid.
Pricing
| Plan | Calls/Day | Calls/Month | Price |
|---|---|---|---|
| Free | 5 | 50 | Free |
| Developer | 20 | 500 | $39/mo |
| Professional | 200 | 5,000 | $99/mo |
| Enterprise | 100,000 | 1,000,000 | $299/mo |
About
ToolWeb.in - 200+ security APIs, CISSP & CISM, platforms: Pay-per-run, API Gateway, MCP Server, OpenClaw, RapidAPI, YouTube.
- toolweb.in
- portal.toolweb.in
- hub.toolweb.in
- toolweb.in/openclaw/
- rapidapi.com/user/mkrishna477
- youtube.com/@toolweb-009
References
- Kong Route: https://api.mkkpro.com/security/email-header-analyser
- API Docs: https://api.mkkpro.com:8016/docs
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install email-header-analyser - After installation, invoke the skill by name or use
/email-header-analyser - Provide required inputs per the skill's parameter spec and get structured output
What is Email Header Analyser?
Analyzes email headers to extract authentication, routing, and security metadata for threat detection and email forensics. It is an AI Agent Skill for Claude Code / OpenClaw, with 117 downloads so far.
How do I install Email Header Analyser?
Run "/install email-header-analyser" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Email Header Analyser free?
Yes, Email Header Analyser is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Email Header Analyser support?
Email Header Analyser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Email Header Analyser?
It is built and maintained by ToolWeb (@krishnakumarmahadevan-cmd); the current version is v1.0.0.