Emoji Score API and MCP

Deterministic public-safe emoji, sentiment, symbolic-expression, combination, and proposal scoring endpoints. Protected model, persistence, reporting, and admin actions use PLATPHORM_API_KEY only.

Base URL
https://emoji.platphormnews.com
Auth
Public-safe reads work without a key. Protected actions accept Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key.
MCP
POST /api/mcp uses JSON-RPC 2.0 and exposes 55 real Emoji Score tools.
Endpoint Inventory
GET
/api/health

Public health summary.

Public
GET
/api/v1/health

Standard health summary.

Public
GET
/api/v1/emoji

List database-backed canonical emoji records.

Public
GET
/api/v1/emoji/{slug}

Get one canonical emoji record by slug.

Public
GET
/api/v1/emoji/by-codepoint/{codepoint}

Get one canonical emoji record by Unicode codepoint sequence.

Public
GET
/api/v1/search

Search canonical emoji records by name, keyword, group, subgroup, emoji, or codepoint.

Public
GET
/api/v1/categories

List database-backed categories.

Public
GET
/api/v1/groups

List database-backed groups.

Public
GET
/api/v1/subgroups

List database-backed subgroups.

Public
GET
/api/v1/keywords

List database-backed keyword index records.

Public
GET
/api/v1/emojis

List Unicode emoji.

Public
GET
/api/v1/emojis/search

Search Unicode emoji.

Public
GET
/api/v1/emojis/categories

List emoji categories.

Public
GET
/api/v1/emojis/{codepoint}

Get one emoji by code point.

Public
GET
/api/v1/timeline

Database-backed Unicode emoji timeline.

Public
GET
/api/v1/new

Recently added emoji records from the canonical data layer.

Public
POST
/api/v1/score

Score an existing emoji or proposal payload.

Public
GET
/api/v1/score/{emojiSlug}

Reserved public score lookup; use POST /api/v1/score for current deterministic scoring.

Public
POST
/api/v1/battle

Compare two emoji scores head-to-head.

Public
POST
/api/v1/sentiment/score

Score sentiment and symbolic meaning.

Public
POST
/api/v1/combinations/score

Score emoji combinations and phrase+emoji expressions.

Public
POST
/api/v1/proposals/score

Score a Unicode-style proposal.

Public
GET
/api/v1/proposals

List ephemeral public-safe proposal results in this runtime.

Public
POST
/api/v1/proposals

Protected server persistence hook backed by the configured database.

Protected
GET
/api/v1/proposals/{id}

Get a public-safe proposal score or stored proposal metadata when available.

Public
POST
/api/v1/proposals/{id}/score

Score a stored proposal by id or slug.

Public
POST
/api/v1/proposals/{id}/export

Export proposal markdown when result is available.

Public
GET
/api/v1/proposals/{id}/download

Download proposal markdown when result is available.

Public
GET
/api/v1/proposal-criteria

List versioned proposal criteria from the scoring registry.

Public
GET
/api/v1/score-dimensions

List versioned score dimensions from the scoring registry.

Public
POST
/api/v1/model/proposal-draft

Protected model-ready proposal writing adapter.

Protected
POST
/api/v1/model/improve-proposal

Protected model-ready improvement adapter.

Protected
POST
/api/v1/model/explain-sentiment

Protected model-ready sentiment explanation adapter.

Protected
POST
/api/v1/model/image-prompt

Protected model-ready image prompt adapter.

Protected
POST
/api/v1/model/accessibility-review

Protected model-ready accessibility review adapter.

Protected
GET
/api/v1/unicode/snapshot

Unicode data snapshot metadata.

Public
POST
/api/v1/unicode/refresh

Protected refresh hook.

Protected
POST
/api/v1/import/unicode

Protected Unicode import hook.

Protected
POST
/api/v1/import/emoji

Protected emoji import hook.

Protected
POST
/api/v1/data/rebuild-search

Protected search index rebuild hook.

Protected
POST
/api/v1/data/recalculate-scores

Protected score recalculation hook.

Protected
GET
/api/docs

Machine-readable API docs.

Public
GET
/openapi.yaml

OpenAPI 3.1 specification.

Public
GET
/openapi.json

OpenAPI 3.1 specification as JSON.

Public
GET
/api/mcp

MCP metadata and usage.

Public
POST
/api/mcp

MCP JSON-RPC 2.0 endpoint.

Public
GET
/data/emoji

Read public-safe canonical emoji records from the Emoji Score data layer.

Public
GET
/data/unicode

Read public-safe canonical unicode records from the Emoji Score data layer.

Public
GET
/data/categories

Read public-safe canonical categories records from the Emoji Score data layer.

Public
GET
/data/groups

Read public-safe canonical groups records from the Emoji Score data layer.

Public
GET
/data/subgroups

Read public-safe canonical subgroups records from the Emoji Score data layer.

Public
GET
/data/keywords

Read public-safe canonical keywords records from the Emoji Score data layer.

Public
GET
/data/aliases

Read public-safe canonical aliases records from the Emoji Score data layer.

Public
GET
/data/timeline

Read public-safe canonical timeline records from the Emoji Score data layer.

Public
GET
/data/proposals

Read public-safe canonical proposals records from the Emoji Score data layer.

Public
GET
/data/scoring

Read public-safe canonical scoring records from the Emoji Score data layer.

Public
GET
/data/sentiment

Read public-safe canonical sentiment records from the Emoji Score data layer.

Public
GET
/data/images

Read public-safe canonical images records from the Emoji Score data layer.

Public
GET
/data/sources

Read public-safe canonical sources records from the Emoji Score data layer.

Public
GET
/data/search

Read public-safe canonical search records from the Emoji Score data layer.

Public
GET
/data/imports

Read public-safe canonical imports records from the Emoji Score data layer.

Public
GET
/data/discovery

Read public-safe canonical discovery records from the Emoji Score data layer.

Public
GET
/data/fixtures

Read public-safe canonical fixtures records from the Emoji Score data layer.

Public
GET
/data/snapshots

Read public-safe canonical snapshots records from the Emoji Score data layer.

Public