Emoji Score

Emoji Score API Documentation

Public-safe REST and MCP surfaces for emoji lookup, deterministic scoring, sentiment and symbolic-expression scoring, Unicode-style proposal scoring, and proposal export. Protected persistence, model generation, reports, and admin actions require PLATPHORM_API_KEY.

OpenAPI
Canonical spec: /openapi.yaml. It uses https://emoji.platphormnews.com and PLATPHORM_API_KEY for protected actions.
MCP JSON-RPC
POST /api/mcp supports initialize, ping, tools/list, tools/call, resources/list, resources/read, prompts/list, and prompts/get.
Model State
Model endpoints return auth-required or degraded/unavailable state unless a server-side provider is configured. No AI output is faked.
REST Endpoints
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
MCP Tools
list_emoji
list_emojis
search_emoji
search_emojis
get_emoji
score_emoji
compare_emoji
score_sentiment
score_emoji_combination
score_phrase_with_emoji
score_proposal
create_proposal_draft
update_proposal_draft
export_proposal
list_scoring_factors
explain_score
generate_improvement_recommendations
generate_proposal_text
generate_image_prompt
generate_accessibility_review
get_unicode_timeline
get_timeline
list_new_emoji
list_categories
list_groups
list_subgroups
list_keywords
get_score_dimensions
get_proposal_criteria
get_data_status
get_database_status
get_import_status
get_agent_policy
list_agent_platforms
get_agent_platform
evaluate_agent_access
get_robots_policy
get_ai_policy
get_trust_policy
get_discovery_manifest
get_public_access_summary
get_health
get_info
get_route_compliance
get_discovery_compliance
create_docs_report
create_sheet_report
create_deck_summary
import_unicode_data
import_emoji_data
rebuild_search_index
recalculate_scores
publish_proposal
update_agent_policy
refresh_agent_platform_registry
MCP Resources
emoji://emojis
emoji://emoji
emoji://emoji/{codepoint}
emoji://categories
emoji://timeline
emoji://new
emoji://score-dimensions
emoji://proposal-criteria
emoji://data-status
emoji://database-status
emoji://scoring-factors
emoji://proposal/{id}
emoji://examples
emoji://sentiment/examples
emoji://openapi
emoji://llms
emoji://trust-policy
agent-policy://summary
agent-policy://platforms
agent-policy://robots
agent-policy://ai-policy
agent-policy://trust-policy
agent-policy://public-access
agent-policy://protected-access
MCP Prompts
score_emoji_idea
score_symbolic_expression
improve_emoji_proposal
create_unicode_style_proposal
explain_emoji_score
explain_sentiment_score
compare_emoji_ideas
generate_proposal_evidence_plan
generate_image_prompt_for_emoji
summarize_unicode_timeline
human_machine_emoji_handoff