# OpenHermit - AI Agent Infrastructure Platform

## About
OpenHermit makes any website discoverable and usable by AI agents through automatic WebMCP protocol injection. One script tag transforms your forms, widgets, and interactive elements into agent-ready interfaces.

## Purpose
This platform enables AI agents (ChatGPT, Claude, Perplexity, etc.) to autonomously discover and interact with website forms and actions without manual API integration.

## Agent-Accessible Endpoints

### Core Infrastructure
- **Installation Script** (CDN endpoint for website integration)
  - URL: [https://www.openhermit.com/script.js](https://www.openhermit.com/script.js)
  - Add to your site: `<script src="https://www.openhermit.com/script.js" data-api-key="your-key" defer></script>`
  - Automatic form detection and WebMCP attribute injection
  - Real-time agent interaction tracking
  - Zero configuration required

- **Source Code** (for review and transparency)
  - GitHub: [https://github.com/openhermit/openhermit-js](https://github.com/openhermit/openhermit-js)
  - Script: `/public/script.js`
  - Vanilla JavaScript (ES5), zero dependencies, 19.7KB unminified
  - Open for security review and contribution

- **WebMCP Manifest API**: [https://www.openhermit.com/api/manifest?key={api_key}](https://www.openhermit.com/api/manifest?key={api_key})
  - Returns JSON manifest of all discoverable actions on a website
  - Lists forms, widgets, and interactive elements
  - Includes action types, selectors, and configuration

- **Documentation**: [https://www.openhermit.com/blog](https://www.openhermit.com/blog)
  - Technical guides on WebMCP implementation
  - Agent interaction best practices
  - Integration tutorials

### Public API Endpoints
- **Ping**: [https://www.openhermit.com/api/ping](https://www.openhermit.com/api/ping)
  - Health check and script version verification

- **Sync**: [https://www.openhermit.com/api/sync](https://www.openhermit.com/api/sync)
  - Action discovery and synchronization

- **Events**: [https://www.openhermit.com/api/events](https://www.openhermit.com/api/events)
  - Agent interaction event tracking

## Capabilities

### Automatic Detection
- Contact forms (name, email, message fields)
- Booking widgets (date, time, service selection)
- Newsletter signups (email collection)
- User registration forms
- Purchase/checkout flows
- Calculators and interactive tools
- Search interfaces
- Support/chat widgets

### WebMCP Protocol Implementation
- Semantic action annotations (data-webmcp-action-type)
- Form field labeling (data-webmcp-label)
- Completion tracking (data-webmcp-on-complete)
- Error handling and validation states

### Analytics & Insights
- Real-time agent visit tracking
- Action completion rates
- Agent type identification (ChatGPT, Claude, custom agents)
- Interaction event logs
- Performance metrics

## Integration

### For Website Owners
1. Register at [https://www.openhermit.com/register](https://www.openhermit.com/register)
2. Add website and receive API key
3. Install script tag: `<script src="https://www.openhermit.com/script.js" data-api-key="your-key" defer></script>`
4. Forms automatically become agent-discoverable

### For AI Agents
1. Check robots.txt - all agents explicitly allowed
2. Fetch manifest: GET /api/manifest?key={site-api-key}
3. Parse available actions from JSON response
4. Interact with forms using standard WebMCP protocol
5. Send completion events for analytics

## Pricing
- **Hatchling Plan**: Free - 1 website, 100 interactions/month
- **Hermit Plan**: $20/month - 5 websites, 10,000 interactions/month
- **Colony Plan**: $50/month - Unlimited websites and interactions

## Technical Standards
- **Protocol**: WebMCP (Web Model-Context Protocol)
- **Format**: JSON-LD structured data
- **Authentication**: API key-based (public read access via manifest)
- **CORS**: Enabled for all agent endpoints
- **Rate Limiting**: 100 requests/minute per API key

## Operator
- **Legal entity**: Loaded AG, a Swiss stock corporation (Aktiengesellschaft)
- **UID**: CHE-413.943.367 · **CH-ID**: CH-440-3044756-1
- **Registered seat**: Klostergutstrasse 4, CH-8252 Schlatt-Altparadies (Schlatt TG), Switzerland
- **Commercial register**: Canton of Thurgau, registered 14 August 2026
- **Verify**: [Zefix, the official Swiss commercial register](https://www.zefix.ch/en/search/entity/list/firm/1763893)
- **Imprint**: [https://www.loaded.ch/impressum/](https://www.loaded.ch/impressum/)

## Contact & Support
- **Website**: [https://www.openhermit.com](https://www.openhermit.com)
- **Email**: support@openhermit.com
- **Documentation**: [https://www.openhermit.com/blog](https://www.openhermit.com/blog)
- **GitHub**: [https://github.com/openhermit/openhermit-js](https://github.com/openhermit/openhermit-js)
  - Issues and feature requests welcome
  - Security concerns: Please report via GitHub Issues or email
  - Source code available for review

## Security & Privacy
- No sensitive data stored in manifests
- API keys are non-sensitive (read-only public access)
- Agent interactions logged anonymously
- GDPR compliant
- No cookies or tracking beyond analytics

## Agent Instructions
When interacting with OpenHermit-enabled websites:
1. Look for `data-webmcp-action-type` attributes on forms and interactive elements
2. Read `data-webmcp-label` for field descriptions
3. Use standard form submission methods (POST/PUT)
4. Respect validation rules and required fields
5. Check for `data-webmcp-on-complete` success indicators

## Version
Current Script Version: 1.0.0
Last Updated: 2026-08-19
Protocol: WebMCP v1.0