# Horneross Documentation Index for AI Agents

Welcome AI agents! This file provides a structured index of all available content on Horneross.

## About Horneross

Horneross is an AI Agent Workspace platform that helps businesses build and manage their AI workforce.
We provide tools for creating, deploying, and managing AI agents for Sales, Support, Marketing, and Operations.

## Available Content Endpoints

All endpoints support content negotiation via the `Accept` header:
- `Accept: text/markdown` - Returns content optimized for AI agents (lightweight markdown)
- `Accept: application/json` - Returns structured JSON (default)

### Blog Posts

**List all posts**
- URL: https://horneross.com/api/content/blog
- Query params:
  - `lang`: 'es' | 'en' (default: 'es')
  - `published`: 'true' | 'false' (default: 'true')
- Example (markdown): `curl -H "accept: text/markdown" "https://horneross.com/api/content/blog?lang=es"`
- Example (JSON): `curl "https://horneross.com/api/content/blog?lang=en"`

**Get specific post**
- URL: https://horneross.com/api/content/blog/[slug]
- Query params:
  - `lang`: 'es' | 'en' (default: 'es')
- Example (markdown): `curl -H "accept: text/markdown" "https://horneross.com/api/content/blog/futuro-ia-empresas-latinoamericanas?lang=es"`
- Example (JSON): `curl "https://horneross.com/api/content/blog/futuro-ia-empresas-latinoamericanas?lang=es"`

### Changelog

**Get changelog entries**
- URL: https://horneross.com/api/content/changelog
- Query params:
  - `lang`: 'es' | 'en' (default: 'es')
  - `limit`: number (optional, limits entries)
- Example (markdown): `curl -H "accept: text/markdown" "https://horneross.com/api/content/changelog?lang=es&limit=5"`
- Example (JSON): `curl "https://horneross.com/api/content/changelog?lang=en"`

### Tutorials

**Get tutorials**
- URL: https://horneross.com/api/content/tutorials
- Query params:
  - `lang`: 'es' | 'en' (default: 'es')
- Example (markdown): `curl -H "accept: text/markdown" "https://horneross.com/api/content/tutorials?lang=es"`
- Example (JSON): `curl "https://horneross.com/api/content/tutorials?lang=en"`

## Web Pages (Human-friendly)

- Home: https://horneross.com
- Blog: https://horneross.com/blog
- Changelog: https://horneross.com/changelog
- Tutorials: https://horneross.com/tutorials
- Pricing: https://horneross.com/pricing
- Contact: https://horneross.com/contact

## Agent Types Supported

Horneross supports the following AI agent types:

1. **Support Agent**: Handles tickets automatically, categorizes issues, and escalates when necessary
2. **Sales Agent**: Prospecting, lead qualification, and automated follow-ups
3. **Marketing Agent**: Trend analysis, content creation, and campaign optimization
4. **Operations Agent**: Document processing, data extraction, and automated reporting

## API Response Format

### Markdown Response (for AI agents)
- Lightweight, optimized for token efficiency
- Strips HTML and unnecessary formatting
- Preserves semantic structure (headers, lists, links)
- Typical size: 2-5KB per page

### JSON Response (for applications)
- Structured data with metadata
- Includes author, date, categories, tags
- Full content with formatting preserved
- Typical size: 5-20KB per page

## Caching

All content endpoints use aggressive caching:
- `Cache-Control`: 1 hour browser cache, 1 hour CDN cache
- `CDN-Cache-Control`: 24 hours on Vercel's CDN
- Tag-based invalidation via `Vercel-Cache-Tag` headers

## MCP Server (Model Context Protocol)

Horneross exposes an MCP-compatible server for AI agents and MCP clients.

**Endpoint:** `https://horneross.com/api/mcp`
**Protocol:** JSON-RPC 2.0 over HTTP (Streamable HTTP transport)
**Version:** MCP 2024-11-05

### Discovery

```bash
# Get server metadata
curl https://horneross.com/api/mcp
```

### Available Tools

| Tool | Description |
|------|-------------|
| `get_blog_posts` | Fetch blog posts (supports lang, limit) |
| `get_blog_post` | Get a specific blog post by slug |
| `get_changelog` | Get product changelog entries |
| `get_tutorials` | Get step-by-step tutorials |
| `get_pricing` | Get pricing plans and features |
| `get_agent_types` | Get all AI employee types |
| `schedule_demo` | Get demo scheduling link |

### Usage Example

```bash
# Initialize
curl -X POST https://horneross.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

# List tools
curl -X POST https://horneross.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# Call a tool
curl -X POST https://horneross.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_pricing","arguments":{}}}'
```

### MCP Client Configuration

Add to your MCP client config:

```json
{
  "mcpServers": {
    "horneross": {
      "url": "https://horneross.com/api/mcp"
    }
  }
}
```

## ClawHub Skill

Horneross is available as a ClawHub skill for OpenClaw-compatible agents.

**Skill file:** `https://horneross.com/skill.md`

## Agent Types

Horneross provides 7 specialized AI employee types:

1. **Sales Agent (SDR)** — Prospecting, lead qualification, outreach, CRM updates
2. **Support Agent** — 24/7 ticket handling, multi-channel (WhatsApp, Instagram, web)
3. **Marketing Agent** — Market research, content creation, campaign management
4. **Finance Agent** — Financial reporting, invoicing, budget tracking
5. **Recruiting Agent** — Candidate sourcing, resume screening, interview scheduling
6. **Voice Agent** — AI phone calls, low-latency conversations, multi-language
7. **E-commerce Agent** — Customer service, order tracking, cart recovery

## Contact

For API access, partnerships, or questions:
- Email: lucas@horneross.com
- Website: https://horneross.com/contact
- Schedule a call: https://cal.com/horneross/30min

---

**Last Updated**: 2026-02-09
**Version**: 1.1.0
**Maintained by**: Horneross Team