suggest_content_emoji

Suggest content emoji

Suggest one unused emoji for the sentence or paragraph immediately before a cursor; content is not modified or published.

Authorization and permissions

Requires a valid delegated OAuth token and access to the selected workspace.

OAuth scope: mcp:ai
Workspace requirement: Authorized workspace and current membership required

Current workspace member; mcp:ai scope, workspace AI quota, and MCP AI rate limit apply.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "content": {
      "description": "Post text, limited to 500 whitespace-separated words.",
      "maxLength": 5000,
      "minLength": 1,
      "type": "string"
    },
    "cursor": {
      "description": "Unicode code-point offset in content; must not exceed content length.",
      "maximum": 5000,
      "minimum": 0,
      "type": "integer"
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id",
    "content",
    "cursor"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "emoji": {
      "description": "One trusted emoji sequence from the service catalog.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "emoji"
  ],
  "type": "object"
}

Example arguments

{
  "content": "We finally shipped the new onboarding flow",
  "cursor": 42,
  "team_id": 42
}

Example result

{
  "emoji": "🎉"
}

Errors and retry

Blank content, more than 500 words/5,000 characters, invalid cursor, provider failures, or exhausted emoji choices are rejected.

The provider call is not idempotent. After a provider or ambiguous failure, retry only if another generation is acceptable.

Effects, limits, and source

Workspace roles, subscription and AI usage limits, approval rules, and server rate limits are enforced at call time. Rate-limit responses identify when to retry; scheduled work returns state rather than holding the request open.

free_tools.emoji_content_fit.api.suggest → services.suggest_emoji