Overview
We've added features to make TinyValidator more accessible to AI agents and automated tools. These changes allow agents to read our documentation and understand how to use our API without manual intervention.
Markdown Content Negotiation
Documentation pages now return markdown when requested with the Accept: text/markdown header or ?format=md query parameter. This means AI agents can consume our docs as structured text instead of parsing HTML.
Example:
curl -H "Accept: text/markdown" https://tinyvalidator.com/docs/guides/verifying-emails
Public Skill File
We've published a SKILL.md file at /skills/tinyvalidator-email-verification/SKILL.md. This file explains:
- When to use single verification vs bulk validation
- What each verification flag means (suggestion, deliverability, disposable, catch_all, role_account)
- How to handle API credentials safely
- Example workflows
AI agents can reference this file to understand how to integrate with our service correctly.
What This Enables
These features support several use cases:
- Automated integrations: Agents can read our docs and implement email verification without step-by-step guidance
- Form validation: Agents understand how to handle edge cases like catch-all domains
- List cleaning: Agents can implement bulk validation workflows by reading our guides
- CRM connections: Agents can make decisions about email quality based on structured information
Additional Resources
We've also added a dedicated page for AI agents at /for-agents and updated our llms.txt file. Both resources provide quick access to integration information in one place.
Availability
These features are available now. No changes to authentication or pricing. Documentation pages automatically return markdown when requested via headers or query parameters.