Skip to main content
Glama
README.md
# verify-mcp

A small [Model Context Protocol](https://modelcontextprotocol.io) server that gives an AI assistant nine read-only lookups for verification work: page history, domain age, redirect chains, sun and shadow maths.

- **No API keys.** Every lookup uses a free public service or is computed locally.
- **No dependencies.** One Python package, standard library only. Python 3.10 or newer.
- **Read-only.** It looks things up. It never posts, saves or publishes anything.
- **No people lookups.** There are no tools for finding a person's accounts, phone, address or face.

## Tools

| Tool | Question it answers | Source |
|---|---|---|
| `wayback_history` | When did this page first exist? What did it say before it was edited? | Internet Archive CDX API |
| `wayback_closest` | What is the archived copy nearest to this date? | Internet Archive |
| `domain_registration` | How old is this website's domain? Who is the registrar? | RDAP (via rdap.org) |
| `dns_records` | Where does this domain point? Who handles its mail? | Cloudflare public DNS |
| `certificate_names` | What sub-sites has this domain run, and since when? | Certificate transparency (crt.sh) |
| `expand_link` | Where does this short link really go? | Direct HEAD requests |
| `reverse_image_links` | Where can I search for earlier copies of this image? | Builds links only |
| `sun_position` | Where was the sun, and which way did shadows fall, at this place and time? | Computed locally (NOAA equations) |
| `shadow_times` | At what time of day does this shadow fit? | Computed locally |

Each result ends with a line on what the lookup cannot show, so the assistant has the caveat in front of it when it writes the answer.

## Install

```
git clone https://github.com/Ghongha007/verify-mcp.git
cd verify-mcp
pip install .
```

**Claude Code**

```
claude mcp add verify -- python3 -m verify_mcp
```

**Claude Desktop and other clients** that use a JSON config:

```json
{
  "mcpServers": {
    "verify": { "command": "python3", "args": ["-m", "verify_mcp"] }
  }
}
```

If you did not `pip install`, set the working directory to this folder, or use the full path to Python and add `"env": {"PYTHONPATH": "/path/to/verify-mcp"}`.

## Examples

Ask the assistant in plain words:

- "This site says it has reported on the region since 2015. When was the domain registered and when did the Wayback Machine first see it?"
- "Where does this short link go? Don't open it."
- "The post says this video was filmed at 5 pm on 16 November at 28.6139, 77.2090. The lamp-post shadow points north-west. Does that fit?"

Sample output of `domain_registration`:

```
Registration record (RDAP) for gephi.org
Registered:   2008-06-02T10:16:57.736Z
Registrar:    Gandi SAS
Name servers: fred.ns.cloudflare.com, lisa.ns.cloudflare.com
Registration date is when the current registration began. A domain can be older
(dropped and re-registered), and registrant details are usually redacted.
```

## What leaves your machine

| Tool | What is sent, and to whom |
|---|---|
| `wayback_history`, `wayback_closest` | the page address, to archive.org |
| `domain_registration` | the domain, to rdap.org and the registry it redirects to |
| `dns_records` | the domain, to cloudflare-dns.com |
| `certificate_names` | the domain, to crt.sh |
| `expand_link` | a HEAD request to the link itself and to each redirect. **The site will see your IP address.** |
| `reverse_image_links`, `sun_position`, `shadow_times` | nothing |

If you are checking a link sent by a hostile party, remember that `expand_link` contacts their server from your network. Use it through a VPN, or not at all.

## Safety choices

- `expand_link` refuses addresses that resolve to private, loopback or link-local networks, and anything that is not http or https. It sends HEAD requests only and never downloads the page. The address is checked before each request; this does not defend against a DNS server that changes its answer between the check and the request, so do not run the server on a machine with sensitive internal services if you plan to expand untrusted links.
- Responses are capped at 2 MB.
- A failed lookup returns a plain error to the assistant and the server keeps running.

## Limits

- The public services behind these tools rate-limit and go down. `crt.sh` in particular is often slow or returns errors; try again later.
- RDAP is not offered by every top-level domain, and many country-code domains return little.
- The sun maths ignores atmospheric refraction, so it is approximate when the sun is within about 3 degrees of the horizon.
- The protocol layer is written by hand against MCP versions 2024-11-05 to 2025-06-18 and supports tools over stdio only. It has been tested with scripted JSON-RPC messages (see `tests/`); it has not yet been tested inside a real MCP client, so please report problems.

## Tests

```
python3 -m unittest discover -s tests
```

The tests run offline.

## Related

- [india-osint](https://github.com/Ghongha007/india-osint): public records and open data for investigating stories in India
- [ai-for-osint](https://github.com/Ghongha007/ai-for-osint): AI tools for investigators, with where each runs and its known limits
- [chat2net](https://github.com/Ghongha007/chat2net): turn a chat or social-media export into a Gephi network
- [osint-skills](https://github.com/Ghongha007/osint-skills): agent skills for verification, geolocation, chronolocation and fact-checking

## Licence

MIT. Made by [OSINT JOURNO](https://github.com/OSINT-JOURNO).