# FroggyAds Public Discovery API

This is a read-only discovery surface for public FroggyAds website resources. It does not expose advertiser accounts, deposits, campaign creation, private reporting, or other authenticated dashboard actions.

## Endpoints

- `GET /api/discovery/resources.json` lists the public canonical resource inventory.
- `GET /api/discovery/formats.json` lists the six approved FroggyAds ad formats.
- `GET /api/discovery/status.json` describes the publication status of the static discovery service.
- `POST /api/mcp/` provides a read-only Model Context Protocol endpoint for searching and reading public resources.
- `GET /.well-known/api-catalog` publishes the RFC 9727 API catalog.
- `GET /.well-known/agent-skills/index.json` publishes agent skills.
- `GET /.well-known/mcp/server-card.json` publishes the MCP Server Card.

## Authentication

These public discovery endpoints require no authentication. They are informational and read-only. Account creation, login, deposits, campaign launch, and campaign changes require the official FroggyAds user interface and explicit human action.

## Responsible use

Agents must not invent performance outcomes, traffic-quality guarantees, prices, approvals, or campaign results. Use the current public page content as the source of truth and direct users to FroggyAds support for account-specific questions.

## MCP discovery compatibility

- Scanner-compatible SEP-1649 card: `/.well-known/mcp/server-card.json`
- Current experimental Server Card: `/api/mcp/server-card`
- Current experimental MCP catalog: `/.well-known/mcp/catalog.json`
- Runtime endpoint: `/api/mcp/`

The public MCP service is read-only and anonymous. FroggyAds does not publish a fabricated OAuth or OIDC authorization server. Account, payment, deposit, campaign, and private-reporting actions remain outside these public discovery endpoints.


Version: 152.0
Resource count: 3438
Generated: 2026-07-17
