Bannerify Public API

Human-readable docs for Bannerify's JSON discovery endpoints, MCP server, agent skills, and WebMCP support.

Overview

Bannerify publishes public, read-only discovery endpoints so AI agents and developer tools can inspect the site's animation preset library and prompt generation workflow without scraping the page HTML.

All endpoints listed here are public. The current API surface does not use protected APIs, so OAuth discovery metadata is intentionally omitted.

JSON Endpoints

Well-Known Discovery

MCP Server

Bannerify also exposes a lightweight HTTP MCP endpoint at `/mcp`. It supports three read-only tools for animation category listing, preset search, and prompt creation. 

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.0",
  "protocolVersion": "2025-06-18",
  "serverInfo": {
    "name": "bannerify-mcp",
    "title": "Bannerify MCP Server",
    "version": "1.0.0"
  },
  "description": "A lightweight MCP server that exposes Bannerify animation discovery and prompt-building tools over HTTP.",
  "documentationUrl": "https://bannerify.hypermatic.com/api/docs#mcp-server",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://bannerify.hypermatic.com/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  }
}

WebMCP

On page load, Bannerify registers the same core capabilities with the browser via `navigator.modelContext`, using `provideContext()` when available and falling back to `registerTool()` for incremental support.

Related Docs