# osintverse-community/email-header-parser

Parses raw email headers into senders, relay hops, IPs and SPF/DKIM/DMARC results

## Install and run

```sh
ot install osintverse-community/email-header-parser
ot run osintverse-community/email-header-parser --headers "Received: from mail.example.org (mail.example.org [93.184.216.34]) by mx.example.net; Mon, 6 Jan 2025 10:00:05 +0000
From: Example <sender@example.org>
Authentication-Results: mx.example.net; spf=pass; dkim=pass; dmarc=pass"
```

The first `ot run` installs the tool after asking once. New to `ot`? See https://otinstaller.com/docs/getting-started.

From an AI agent, through ot's MCP server (`ot mcp`):

```
run_tool {"tool":"osintverse-community/email-header-parser","inputs":{"headers":"Received: from mail.example.org (mail.example.org [93.184.216.34]) by mx.example.net; Mon, 6 Jan 2025 10:00:05 +0000\nFrom: Example <sender@example.org>\nAuthentication-Results: mx.example.net; spf=pass; dkim=pass; dmarc=pass"}}
```

## Inputs

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `headers` | string | yes |  | The raw headers, as copied from "Show original"; \n escapes are accepted |

## Outputs

Finds: email, domain, ip.

## What a run does

- Does not contact the target.
- Collects personal data.
- Does not need an account.
- Runs offline (no network access).

An agent needs the person's consent before running this tool, because it collects personal data. See https://otinstaller.com/docs/agents#consent.

## Trust

- Latest version: 0.1.0
- Signed: yes
- Verified publisher: yes
- Health: healthy
- Installs in the last 30 days: 0
- License: MIT
- Runtime: Docker image, pinned by digest
- Repository: https://github.com/osintverse-community/email-header-parser
- Packaged by the community from a third-party tool

## Links

- Web page: https://otinstaller.com/osintverse-community/email-header-parser
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/email-header-parser
- README: https://github.com/osintverse-community/email-header-parser#readme
- Security details: https://otinstaller.com/osintverse-community/email-header-parser/security