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/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
POST
/api/v1/score

Score an existing emoji or proposal payload.

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; degraded without database.

Protected
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
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/timeline

Unicode emoji timeline.

Public
GET
/api/v1/unicode/snapshot

Unicode data snapshot metadata.

Public
POST
/api/v1/unicode/refresh

Protected refresh hook.

Protected
GET
/api/docs

Machine-readable API docs.

Public
GET
/openapi.yaml

OpenAPI 3.1 specification.

Public
GET
/api/mcp

MCP metadata and usage.

Public
POST
/api/mcp

MCP JSON-RPC 2.0 endpoint.

Public
MCP Tools
list_emojis
search_emojis
get_emoji
score_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
list_categories
get_health
get_info
get_route_compliance
get_discovery_compliance
create_docs_report
create_sheet_report
create_deck_summary
MCP Resources
emoji://emojis
emoji://emoji/{codepoint}
emoji://categories
emoji://timeline
emoji://scoring-factors
emoji://proposal/{id}
emoji://examples
emoji://sentiment/examples
emoji://openapi
emoji://llms
emoji://trust-policy
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