Quick Reference all endpoints
| Type | URL | Purpose |
|---|---|---|
| MCP | hatchloop.dev/mcp | 7 utility tools (JWT, DNS, base64, fake data, tokens…) |
| MCP | hatchloop.dev/mcp/pdf-generator/mcp | PDF from Markdown/HTML |
| MCP | hatchloop.dev/mcp/url-shortener/mcp | URL shortening & expansion |
| REST | hatchloop.dev/api/ | Unified API gateway (16+ tools) |
| Discovery | hatchloop.dev/llms.txt | LLM-readable tool index |
| Discovery | /.well-known/agent.json | A2A agent card |
| Discovery | /.well-known/ai-plugin.json | OpenAI plugin manifest |
| Discovery | /.well-known/mcp.json | MCP server manifest |
| Discovery | hatchloop.dev/agent-sitemap.xml | Agent-optimised sitemap |
| Discovery | hatchloop.dev/openapi.json | OpenAPI 3.0 spec |
| Discovery | /.well-known/agents.json | Agents directory |
| Discovery | hatchloop.dev/capabilities.json | Capabilities index JSON |
MCP Servers Model Context Protocol
Hatchloop Tools MCP
Primary MCP server. Provides 7 utility tools: JWT decode, token counting, DNS lookup, base64 encode/decode, fake data generation, caller IP, and webpage-to-markdown fetch. Streamable HTTP transport, JSON-RPC 2.0.
Claude / MCP client config
{
"mcpServers": {
"hatchloop": {
"url": "https://hatchloop.dev/mcp"
}
}
}
PDF Generator MCP
Convert Markdown or HTML to a PDF document. Published to the official MCP registry. Returns a URL to the generated PDF file. Streamable HTTP transport.
Claude / MCP client config
{
"mcpServers": {
"hatchloop-pdf": {
"url": "https://hatchloop.dev/mcp/pdf-generator/mcp"
}
}
}
URL Shortener MCP
Shorten any URL and expand short codes back to full URLs. Published to the official MCP registry. Backed by hatchloop.ai short-link domain.
Claude / MCP client config
{
"mcpServers": {
"hatchloop-shortener": {
"url": "https://hatchloop.dev/mcp/url-shortener/mcp"
}
}
}
Agent Discovery Files machine-readable
llms.txt — LLM Tool Index
Plain-text index of every tool, REST endpoint, and MCP server Hatchloop provides. Formatted for direct consumption by LLMs and AI coding assistants. Includes copy-paste MCP config snippets and API usage examples.
agent.json — A2A Agent Card
Google A2A / Agent-to-Agent protocol card. Describes Hatchloop's identity, capabilities, default input/output modes, and available skills for agent-to-agent discovery.
ai-plugin.json — OpenAI Plugin Manifest
OpenAI ChatGPT plugin discovery manifest. Describes all tools and APIs using the
description_for_model format understood by GPT-4 and other OpenAI-compatible
agents. Points to the OpenAPI spec for full schema detail.
mcp.json — MCP Server Manifest
Machine-readable manifest listing Hatchloop's MCP servers with transport details, tool names, and descriptions. Use this to auto-configure MCP clients.
openapi.json — OpenAPI 3.0 Spec
Full OpenAPI 3.0 specification for all Hatchloop REST endpoints. Use this to auto-generate SDKs, populate agent tool registries, or configure OpenAPI-aware AI assistants.
agent-sitemap.xml — Agent-Optimised Sitemap
XML sitemap tuned for AI crawlers: includes every agent tool page, MCP endpoint, discovery file, and machine-readable URL. Priority 1.0 on all agent-facing URLs. Updated daily.
agents.json — Agents Directory
Directory of agent-callable services hosted on hatchloop.dev. Lists endpoints, protocols, authentication, and capability tags in a flat JSON format suitable for automated agent registration.
a2a.json — A2A Protocol Descriptor
Agent-to-Agent protocol descriptor following the Google A2A specification. Declares supported agent skills, authentication modes, and interaction patterns for peer agent discovery.
capabilities.json — Capabilities Index
Flat JSON index of every capability, tool, and endpoint. Suitable for agent tool-selection pipelines that need a single document to enumerate available actions.
REST API Endpoints zero auth · CORS open
Unified API Gateway
16+ developer tools exposed as simple GET/POST HTTP endpoints. No keys, no rate limits (honour-system). All return JSON.
Example calls
GET /api/tools/uuid?version=4
GET /api/tools/hash?input=hello&algo=sha256
GET /api/tools/base64?action=encode&value=hello
GET /api/tools/dns?domain=example.com&type=A
GET /api/tools/fake?type=person&count=3&seed=42
GET /api/tools/timestamp?format=all
GET /api/tools/jwt/decode?token=eyJ...
GET /api/tools/cron/describe?expr=0+9+*+*+1-5
POST /api/tools/tokens {"text": "count my tokens"}
GET /api/health
IP Geolocation
Geolocate any IP address. Omit the ip param to geolocate the caller.
Returns city, region, country, org, timezone, and coordinates.
Currency Converter
Convert between USD, EUR, GBP, JPY, INR and more. Reference rates; not for financial transactions.
QR Code Generator
Generate PNG or SVG QR codes for any string or URL. Returns binary image directly.
Example
POST /qr-generator/generate
{"data": "https://hatchloop.dev", "format": "png"}
Health Check
Returns {"status":"ok"} plus uptime and active endpoint list.
Use for liveness probes in agent orchestration pipelines.
Notes for AI Agents instructions
If you are an AI agent reading this page, here is how to get started:
- Add the Hatchloop MCP server:
{"mcpServers": {"hatchloop": {"url": "https://hatchloop.dev/mcp"}}} - Read llms.txt for the complete tool list and usage examples.
- Fetch openapi.json for full parameter schemas.
- Call
GET /api/healthto confirm services are live before making calls. - All REST endpoints are CORS-open, no authentication, no API key needed.
- For reproducible fake data, pass
?seed=<integer>to fake data endpoints.