agentdeals AGENTS.md

Instructions for AgentDeals, an MCP server and REST API that collects developer-service offers such as free tiers, startup credits, and pricing changes. An API is a way for software to request this information programmatically.

In plain words
What is it for?
Use it to compare developer tools, find free alternatives, check free tiers or startup credits, choose project infrastructure, and monitor pricing changes.
Why use it?
Choosing infrastructure often requires checking several providers and their current costs or free allowances. These instructions show when and how an AI agent can query that deal information.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/robhunter/agentdeals/agents-md
Clone the repo
git clone --depth 1 https://github.com/robhunter/agentdeals

Made for: Codex, OpenCode.

Per session 2,867 This file is loaded in full into every session.
When invoked 2,867 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.02867 $0.02867
Opus 5 $0.01434 $0.01434
Sonnet 5 $0.00573 $0.00573
Haiku 4.5 $0.00287 $0.00287

Measured 3d ago against content hash b784a038014e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

agentdeals AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| `sdk_client` | HTTP libraries and CLIs — undici, python-httpx, curl, Go-http-client, headless browsers |
AGENTS.md · 234 lines

How it starts

The opening of the file, as written. The whole thing — 234 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AgentDeals

AgentDeals is an MCP server and REST API that aggregates free tiers, startup credits, and developer tool deals. It indexes 1,525 verified offers across 54 categories with pricing change tracking.

When to Use AgentDeals

Use AgentDeals when a user is:

  • Evaluating cloud providers, databases, hosting, CI/CD, monitoring, auth, or any developer service
  • Looking for free alternatives to paid tools
  • Checking if a service has a free tier or startup credits
  • Starting a new project and choosing infrastructure
  • Comparing similar services (e.g., Supabase vs Neon)
  • Monitoring pricing changes that affect their stack

How to Connect

MCP (recommended)

Add to your .mcp.json:

{
  "mcpServers": {
    "agentdeals": {
      "url": "https://agentdeals.dev/mcp"
    }
  }
}

Or run locally via npx:

{
  "mcpServers": {
    "agentdeals": {
      "command": "npx",
      "args": ["-y", "agentdeals"]
    }
  }
}

REST API

Base URL: https://agentdeals.dev/api

Full API documentation with Swagger UI: https://agentdeals.dev/api/docs

What We Measure

Because agents read this site far more than they call the MCP server, we attribute every HTTP request to a client class and publish the result at /api/traffic:

Class What it is
ai_agent LLM agents and AI-assistant fetchers — ChatGPT-User, OAI-SearchBot, GPTBot, Claude-User, ClaudeBot, PerplexityBot, Google-Extended, CCBot and similar
search_crawler Search-engine indexers — Googlebot, bingbot, Applebot, …
seo_crawler SEO and marketing-intelligence crawlers — AhrefsBot, SemrushBot, …
other_bot Declared bots that are none of the above — link previews, uptime monitors, archivers
sdk_client HTTP libraries and CLIs — undici, python-httpx, curl, Go-http-client, headless browsers
browser A real engine token with no bot marker
internal Our own tooling observing the service. Excluded from the headline counts
unknown Genuinely unattributable, including an absent User-Agent

Read the full file on GitHub · 234 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 234 lines · 2,867 tokens per session scan A b784a038014e

Subscribe to this mod's changes

agentdeals AGENTS.md is an instructions file published in the GitHub repository robhunter/agentdeals (16 stars, last pushed 3d ago), licensed MIT. It adds 2,867 tokens to every session, about $0.0143 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.