audd.io

{
  "name": "search_audd_docs",
  "kind": "answer",
  "impl": "imperative",
  "description": "Keyword search across AudD's public API documentation (docs.audd.io: API reference, agent guide, enterprise endpoint for long files, live stream monitoring, SDK overview, MCP server, CLI, custom catalog) and the audd.io overview. Returns the best-matching sections with short excerpts and source links. Use it to find where something is documented, then read the section with read_audd_doc.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 2,
        "maxLength": 200,
        "description": "Keywords or a question, e.g. \"longpoll without callback url\" or \"enterprise limit parameter\"."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10,
        "description": "Optional: number of sections to return (1-10). Default 5."
      }
    },
    "additionalProperties": false,
    "required": [
      "query"
    ]
  }
}

{
  "name": "read_audd_doc",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read one page of AudD's API documentation (docs.audd.io) as markdown. Pages: index (the full HTTP API reference), skill (guide for AI agents), enterprise (long audio and video files), streams (live stream monitoring), sdks (SDK overview), sdks/<language>, mcp (MCP server), cli (command-line tool), upload_audio_endpoint (custom catalog). Use section to get one part; long pages come in chunks (offset).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "page": {
        "type": "string",
        "enum": [
          "index",
          "skill",
          "enterprise",
          "streams",
          "sdks",
          "mcp",
          "cli",
          "upload_audio_endpoint",
          "sdks/python",
          "sdks/node",
          "sdks/go",
          "sdks/rust",
          "sdks/php",
          "sdks/swift",
          "sdks/kotlin",
          "sdks/dotnet",
          "sdks/java",
          "sdks/c",
          "sdks/cpp"
        ],
        "description": "Docs page, e.g. \"index\", \"streams\" or \"sdks/python\"."
      },
      "section": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120,
        "description": "Optional: return only the section under the first heading matching this text (case-insensitive), or a \"Parent > Child\" heading path."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000,
        "description": "Optional: character offset to continue from, as given at the end of a truncated result. Default 0."
      },
      "max_chars": {
        "type": "integer",
        "minimum": 500,
        "maximum": 40000,
        "description": "Optional: maximum characters of content to return (500-40000). Default 12000."
      }
    },
    "additionalProperties": false,
    "required": [
      "page"
    ]
  }
}

{
  "name": "get_audd_pricing",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get AudD's current pricing page as markdown: plans and per-request rates, what a month costs at different volumes, how long files and live streams are counted, stream monitoring, how to subscribe, and pricing FAQs (from https://audd.io/pricing/). Use it instead of quoting prices from memory.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "section": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120,
        "description": "Optional: return only the section under the first heading matching this text (case-insensitive), or a \"Parent > Child\" heading path."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000,
        "description": "Optional: character offset to continue from, as given at the end of a truncated result. Default 0."
      },
      "max_chars": {
        "type": "integer",
        "minimum": 500,
        "maximum": 40000,
        "description": "Optional: maximum characters of content to return (500-40000). Default 12000."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "search_audd_guides",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search AudD's how-to guides at audd.io/resources: recipes (e.g. a Shazam-style app, a copyright scanner, a now-playing widget, a DJ-set tracklist), concepts, platform integrations, solutions by role, articles, field references, migration guides and notes for AI agents. Returns titles, summaries and links. Call with no arguments to list the categories. Read a guide with read_audd_guide.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 2,
        "maxLength": 200,
        "description": "Optional: keywords, e.g. \"discord bot\" or \"migrate from acrcloud\"."
      },
      "category": {
        "type": "string",
        "enum": [
          "recipes",
          "concepts",
          "integrations",
          "solutions",
          "articles",
          "reference",
          "migrate",
          "agents"
        ],
        "description": "Optional: only guides in this category."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "description": "Optional: number of guides to return (1-50). Default 10."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "read_audd_guide",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read one AudD how-to guide from audd.io/resources as markdown, by the path that search_audd_guides returns (e.g. /resources/recipes/shazam-clone). Use section to get one part; long guides come in chunks (offset).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "path": {
        "type": "string",
        "minLength": 12,
        "maxLength": 200,
        "pattern": "^/resources/[a-z0-9-]+(/[a-z0-9-]+){1,3}$",
        "description": "Guide path such as \"/resources/recipes/shazam-clone\" (a full https://audd.io/resources/... URL also works)."
      },
      "section": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120,
        "description": "Optional: return only the section under the first heading matching this text (case-insensitive), or a \"Parent > Child\" heading path."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000,
        "description": "Optional: character offset to continue from, as given at the end of a truncated result. Default 0."
      },
      "max_chars": {
        "type": "integer",
        "minimum": 500,
        "maximum": 40000,
        "description": "Optional: maximum characters of content to return (500-40000). Default 12000."
      }
    },
    "additionalProperties": false,
    "required": [
      "path"
    ]
  }
}

{
  "name": "get_audd_agent_skill",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get AudD's Agent Skills: instruction files that teach an AI agent to call the AudD API directly (audd-music-recognition for files and URLs, audd-stream-monitoring for live streams). Call without skill to list them with descriptions; pass skill to read one skill file.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "skill": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^[a-z0-9-]+$",
        "description": "Optional: skill name, e.g. \"audd-music-recognition\" or \"audd-stream-monitoring\"."
      },
      "section": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120,
        "description": "Optional: return only the section under the first heading matching this text (case-insensitive), or a \"Parent > Child\" heading path."
      },
      "offset": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000,
        "description": "Optional: character offset to continue from, as given at the end of a truncated result. Default 0."
      },
      "max_chars": {
        "type": "integer",
        "minimum": 500,
        "maximum": 40000,
        "description": "Optional: maximum characters of content to return (500-40000). Default 12000."
      }
    },
    "additionalProperties": false
  }
}

{
  "name": "get_started_with_audd",
  "kind": "answer",
  "impl": "imperative",
  "description": "How to start using AudD: getting an API token on the dashboard and keeping it safe, the first API request and which endpoint to use, the official SDKs, the AudD MCP server for agents (mcp.audd.io), and authentication for agents (auth.md). A short overview with links.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
}