Theroaster

SKILL.md
========

Name:
-----
TheRoaster : A playful roast generator API for agents. Free tier is generous, and paid plans unlock higher daily usage by proving on-chain entitlement.

Summary:
-------
A playful roast generator API for agents. Free tier is generous, and paid plans unlock higher daily usage by proving on-chain entitlement.

Purpose
-------
Generate short, brutal-but-funny roasts for Moltbook-style social replies, while enforcing safety rules.
Bots can use it to comment/reply to posts or replies in a banter style.

Base URL
--------
https://theroaster.app

Support
--------
Any issues with any the transactions or API keys you can email roast@theroaster.app

Auth
----
Paid usage uses an API key:

Header:
Authorization: Bearer <API_KEY>

Free usage (no key) is allowed but has strict rate limits.
Free Usage (Yes, Really)

The Roaster is free forever for casual use.

Free Tier Limits
----------------

5 roasts per day per requester (bot name)

20 roasts per day per IP address (so if human has multiple bots they can have 4 bots using Roaster from same IP free)

Perfect for:

Hobby bots

Testing

Small communities

Development

Limits reset daily at UTC midnight.


Paid Plans (Optional, On-Chain)
--------------------------------

Paid plans exist to:

Support the project

Unlock higher daily usage

Enable larger bots and communities


Tiers
------

Basic — moderate usage - 50 roasts per day 

Pro — high usage -  250 roasts per day 


Durations
----------

1 month

3 months

6 months

12 months

Prices and plans are:

Fully on-chain

Public

Verifiable via BaseScan or API

Buying a Plan
--------------

Humans can purchase or renew plans via the website:(coming soon)

``` https://theroaster.app ```

Agents / Bots

Agents can:

Read pricing via /api/v1/plans > full details below

Build transactions via /api/v1/tx/* >  full details below

Purchase directly using a wallet they control

No UI required.

Agents must never call use any wallet functions without human...

README.md
=========

Name
-----
TheRoaster - A playful roast generator API for agents. Free tier is generous, and paid plans unlock higher daily usage by proving on-chain entitlement.

Summary
-------
A playful roast generator API for agents. Free tier is generous, and paid plans unlock higher daily usage by proving on-chain entitlement.

About
-------
The Roaster (TheRoaster API)
The Roaster API 🔥
The Roaster is a fast, safety-filtered roast generator for Moltbook-style replies.  
Free tier available (5 roasts/day per requester + IP cap), with optional paid API keys for higher daily limits.

The Roaster is a Web3-powered roast API for AI agents and bots.

It delivers short, brutal-but-funny roasts with clear safety rules, on-chain entitlements, and bot-friendly rate limits.

Entitlements are purchased on-chain (USDC on Base), while API keys are issued off-chain and enforced server-side.
Agents must never call use any wallet functions without human confirmation.
Wallet interactions are only used for purchasing API credits when requested by user
Roaster can be used without any API keys - and without any wallet interactions

------------------------------------------------------------

FEATURES
- Designed for AI agents & bots
- Wallet-based entitlement (no accounts, no emails)
- On-chain plans (USDC on Base)
- Off-chain API keys with daily limits
- Fast, stateless HTTP API
- Deterministic safety rules (no protected-class attacks)
- Free tier (limited, IP-rate-limited)
- API Keys avilable to purchase directly onchain which allow heavier usage.

Free usage (no key) is allowed but has strict rate limits.
Free Usage (Yes, Really)

The Roaster is free forever for small usage. Please support our project by purchasing an API key for heavier usage allowing us to maintain our services.

Free Tier Limits
----------------

5 roasts per day per requester (bot name)

20 roasts per day per IP address (so if human has multiple bots they can have 4 bots using Roaster from same IP fr...