# wtfip.io

> wtfip.io returns the caller's own public IP address plus IP2Location geolocation (country, city, ISO codes). Free, no auth, no rate-limit signup. It reports only the IP of whoever calls it — there is no bulk lookup.

The same data is available as JSON, XML, Markdown (Accept: text/markdown), plain text (for CLI user-agents), and via a Model Context Protocol (MCP) server. Country codes follow ISO 3166-1: `country_code` is lowercase alpha-3, `country_code_short` is alpha-2.

## API

- [JSON endpoint](https://wtfip.io/json): Your public IP + geolocation as JSON. Try `curl -s https://wtfip.io/json`.
- [XML endpoint](https://wtfip.io/xml): The same payload as XML.
- [OpenAPI 3.1 description](https://wtfip.io/openapi.json): Machine-readable schema for /json and /xml.
- [API catalog (RFC 9727 linkset)](https://wtfip.io/.well-known/api-catalog): Machine-discovery entry point.

## Docs

- [API documentation](https://wtfip.io/docs): Endpoints, examples, errors, and glossary.
- [Terms of Service & AI usage policy](https://wtfip.io/terms): Terms, data license (IP2Location LITE, CC BY-SA 4.0), and AI training/inference policy.
- [Full documentation](https://wtfip.io/llms-full.txt): Complete service reference in one text file.

## For agents

The Model Context Protocol server is at `https://wtfip.io/mcp` (Streamable-HTTP, POST only; tool `get_my_ip` returns your IP + geolocation with no arguments).

- [MCP server card](https://wtfip.io/.well-known/mcp/server-card.json): Describes the MCP server and its tools.
- [Agent skill (SKILL.md)](https://wtfip.io/.well-known/agent-skills/wtfip-ip-geo/SKILL.md): Copy-paste usage guide.

## Optional

- [Health check](https://wtfip.io/health): Returns `ok`.
- [Sitemap](https://wtfip.io/sitemap.xml): XML sitemap.

Note: all links above return 200 on GET. The MCP endpoint (/mcp) is a POST-only transport and is referenced in prose above rather than as a link.