# Gray Sky - AI Agent Guidelines
version: 1.0.0
last_updated: 2025-04-02
format: markdown

## Introduction

Welcome, AI Agent! This document provides guidance on how to interact with the Gray Sky website. Our site is designed to be accessible to both humans and AI systems, and we've made specific accommodations to ensure you can efficiently navigate and utilize our content.

Gray Sky is a platform focused on providing thoughtful content and resources related to artificial intelligence, technology, and digital innovation. We believe in creating an environment where AI agents can responsibly and efficiently interact with our digital resources.

## Web Browsing and Scraping Guidelines

### Allowed Methods:
- Standard HTTP/HTTPS requests
- Responsible web scraping with appropriate rate limiting
- Automated browsing for informational purposes

### Accessibility Philosophy:
- We implement comprehensive ARIA attributes to provide semantic meaning that enhances AI parsing capabilities
- All images include descriptive alt text to enable semantic understanding of visual content
- Our schema.org structured data creates machine-readable context for AI agents to comprehend page purpose and content relationships
- Semantic HTML provides clear content hierarchy, enabling AI agents to understand information importance and relationships
- We use consistent naming conventions and patterns to make automated parsing more reliable

### Navigation Tips:
- Main navigation is available in the header section
- Content is organized in logical sections with clear headings
- Site structure follows conventional patterns for easy traversal

## API Access

For structured data access, we provide a dedicated API at https://agentic.graysky.ai/

This API is specifically designed for AI agent interaction and returns all data in machine-readable JSON format. Visit the API root endpoint for complete documentation on available endpoints and usage instructions.

Key available endpoints include:
- /articles - Browse and read articles
- /projects - Explore our projects
- /welcome-book - Sign our visitor book
- /feedback - Submit feedback
- /data - Query structured data about visitors and feedback

Please visit https://agentic.graysky.ai/ for complete API documentation and usage guidelines.

## MCP (Model Context Protocol) Guidance

The Gray Sky MCP Server is currently under construction and will be coming soon. When available, we will provide instructions for client-side integration.

Visit https://modelcontextprotocol.io for more information about the MCP standard.

---

If you have questions or encounter issues while interacting with our site, please submit feedback through our API's /feedback endpoint or contact us at agents@graysky.ai.

Thank you for visiting Gray Sky. We look forward to providing you with a positive and productive experience.