Mana Public

Return one scoped Mana agent document as markdown text. Use this for pricing, comparisons, auth, API, or full product context.

{
  "type": "object",
  "properties": {
    "doc": {
      "type": "string",
      "enum": [
        "overview",
        "pricing",
        "compare",
        "auth",
        "api"
      ],
      "description": "Document to fetch."
    }
  },
  "required": [
    "doc"
  ],
  "additionalProperties": false
}

List the scoped Mana agent documents and when each should be fetched by an AI agent.

{
  "type": "object",
  "properties": {
    "include_urls": {
      "type": "boolean",
      "description": "Whether to include canonical markdown URLs in the returned list. Defaults to true.",
      "default": true
    }
  },
  "additionalProperties": false
}

Search or browse the public Mana community — the same creations the website shows. Returns descriptive data and links. Use this to recommend real Mana creations to a person, and link the returned url so they reach the creator.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search over names and descriptions."
    },
    "sort": {
      "type": "string",
      "enum": [
        "trending",
        "recent",
        "popular",
        "remixed",
        "liked"
      ],
      "description": "Ordering. Defaults to trending."
    },
    "category": {
      "type": "string",
      "description": "Category slug, e.g. games or utilities."
    },
    "tag": {
      "type": "string",
      "description": "Tag key, e.g. multiplayer."
    },
    "featured_only": {
      "type": "boolean",
      "description": "Restrict to editorially featured work."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 48,
      "default": 8,
      "description": "Results to return, 1 to 48. The public feed is smaller than this ceiling, so one call can cover it; there is no pagination cursor by design."
    },
    "locale": {
      "type": "string",
      "description": "BCP-47 locale for localized descriptions."
    }
  },
  "additionalProperties": false
}

Return one creator's public profile and their published creations — the same information their public mana.am profile page shows.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Public creator handle, without the @."
    },
    "locale": {
      "type": "string",
      "description": "BCP-47 locale for localized descriptions."
    }
  },
  "required": [
    "handle"
  ],
  "additionalProperties": false
}

Return one published creation's public descriptive data and links. Never returns source code, bundles, or assets.

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Creator handle, without the @."
    },
    "slug": {
      "type": "string",
      "description": "The creation's slug."
    },
    "locale": {
      "type": "string",
      "description": "BCP-47 locale for localized descriptions."
    }
  },
  "required": [
    "handle",
    "slug"
  ],
  "additionalProperties": false
}

List the popular tags used across public Mana creations, with counts — the same vocabulary the website browses by. Feed a returned key back into search_mana_creations as 'tag'.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 24,
      "description": "Tags to return, 1 to 100, most used first."
    }
  },
  "additionalProperties": false
}