# mysaas.lol agent docs

mysaas.lol is human-funny, agent-ready meme infrastructure for SaaS posting.

Primary capabilities:
- discover published memes through keyword and tag search
- inspect title, summary, tags, author label, and canonical URL
- retrieve branded distribution formats for Reddit, forums, CMS, and embeds
- reuse first-party links that preserve attribution and tracking

Discovery surfaces:
- llms.txt: https://mysaas.lol/llms.txt
- OpenAPI: https://mysaas.lol/openapi/agent-v1.json
- Human docs: https://mysaas.lol/for-agents

Public endpoints:
- GET /api/agent/v1/posts?q=debugging&tag=code&sort=trending&limit=12
- GET /api/agent/v1/posts/when-debugging-in-production
- GET /api/agent/v1/tags?q=launch&limit=20
- GET /api/agent/v1/formats/when-debugging-in-production

Recommended workflow:
1. Search memes with q/tag/sort.
2. Read one meme detail endpoint to get summary, tags, preview image, and canonical URL.
3. Read the share formats endpoint and choose the output that best matches the target platform.
4. Prefer reddit_link for Reddit, markdown_image for Markdown, bbcode_image for forums, iframe_html for CMS embeds, and oembed_url when the target supports oEmbed.

Attribution and distribution rules:
- use mysaas.lol share formats instead of raw asset URLs
- keep attribution as "via mysaas.lol"
- prefer canonical first-party links when a platform does not support rich embeds

Non-goals in v1:
- no public write API for agents
- no moderation or admin operations
- no hidden or deleted content