# Emoji Score

> Score emoji, sentiment, symbolic expressions, emoji combinations, and Unicode-style emoji proposals with deterministic public-safe tooling.
> Public-safe emoji scoring, sentiment scoring, symbolic-expression scoring, proposal scoring, Unicode data browsing, API docs, and read-only MCP introspection are available without a key.

Emoji Score is the PlatPhormNews public creative-linguistic intelligence layer for emoji lookup, deterministic emoji scoring, sentiment/tone scoring, symbolic-expression scoring, emoji-combination scoring, Unicode-style proposal development, proposal export, and MCP/API tooling.

Dataset: 3,944 fully-qualified Unicode emoji from unicode.org/Public/emoji/latest/emoji-test.txt, version 17.0.
Data layer: postgres; 18 public-safe /data/* domains; score weights total 100%.
Auth: protected actions use PLATPHORM_API_KEY only through Authorization: Bearer or X-PlatPhorm-API-Key.
Trace: operations create W3C trace context and link to trace.platphormnews.com when Trace accepts public spans.

## Pages

- [Emoji Score](https://emoji.platphormnews.com): Score emoji, sentiment, combinations, and proposal ideas.
- [Explore Emoji](https://emoji.platphormnews.com/explore): Search and browse the Unicode emoji dataset.
- [Emoji Timeline](https://emoji.platphormnews.com/timeline): Browse emoji releases by Unicode Emoji version year.
- [New Emoji](https://emoji.platphormnews.com/new): Recently added Unicode emoji.
- [Recently Added Emoji](https://emoji.platphormnews.com/recently-added): Compatibility route for new emoji.
- [Propose Emoji](https://emoji.platphormnews.com/propose): Build and score a Unicode-style emoji proposal.
- [Submit Emoji Proposal](https://emoji.platphormnews.com/submit): Compatibility route for proposal wizard.
- [Emoji Score API](https://emoji.platphormnews.com/api): Human API and MCP quick start.
- [API Documentation](https://emoji.platphormnews.com/docs): Detailed REST and MCP documentation.
- [About Emoji Score](https://emoji.platphormnews.com/about): Methodology and product background.
- [Emoji Score FAQ](https://emoji.platphormnews.com/faq): Frequently asked questions for humans and agents.
- [Privacy](https://emoji.platphormnews.com/privacy): Public/private data boundary and local draft policy.
- [Terms](https://emoji.platphormnews.com/terms): Use terms and Unicode affiliation disclaimer.
- [Disclaimer](https://emoji.platphormnews.com/disclaimer): Unicode and model-output disclaimer.
- [API Docs JSON](https://emoji.platphormnews.com/api/docs): Machine-readable API documentation.
- [OpenAPI YAML](https://emoji.platphormnews.com/openapi.yaml): OpenAPI specification.
- [OpenAPI JSON](https://emoji.platphormnews.com/openapi.json): OpenAPI specification in JSON.
- [RSS](https://emoji.platphormnews.com/rss.xml): Public Emoji Score update feed.
- [Atom Feed](https://emoji.platphormnews.com/feed.xml): Public Emoji Score Atom feed.
- [MCP Discovery](https://emoji.platphormnews.com/.well-known/mcp.json): MCP discovery manifest.
- [Agents Policy](https://emoji.platphormnews.com/.well-known/agents.json): Agent discovery manifest.
- [Agent Access Policy](https://emoji.platphormnews.com/.well-known/agent-policy.json): Agent platform access policy.
- [AI Policy](https://emoji.platphormnews.com/.well-known/ai-policy.json): AI crawler and model-use policy.
- [Trust Policy](https://emoji.platphormnews.com/.well-known/trust.json): Public/protected boundary.
- [Security Policy](https://emoji.platphormnews.com/.well-known/security.txt): Security contact file.

## API

- GET /api/health: Public health summary. Public-safe.
- GET /api/v1/health: Standard health summary. Public-safe.
- GET /api/v1/emoji: List database-backed canonical emoji records. Public-safe.
- GET /api/v1/emoji/{slug}: Get one canonical emoji record by slug. Public-safe.
- GET /api/v1/emoji/by-codepoint/{codepoint}: Get one canonical emoji record by Unicode codepoint sequence. Public-safe.
- GET /api/v1/search: Search canonical emoji records by name, keyword, group, subgroup, emoji, or codepoint. Public-safe.
- GET /api/v1/categories: List database-backed categories. Public-safe.
- GET /api/v1/groups: List database-backed groups. Public-safe.
- GET /api/v1/subgroups: List database-backed subgroups. Public-safe.
- GET /api/v1/keywords: List database-backed keyword index records. Public-safe.
- GET /api/v1/emojis: List Unicode emoji. Public-safe.
- GET /api/v1/emojis/search: Search Unicode emoji. Public-safe.
- GET /api/v1/emojis/categories: List emoji categories. Public-safe.
- GET /api/v1/emojis/{codepoint}: Get one emoji by code point. Public-safe.
- GET /api/v1/timeline: Database-backed Unicode emoji timeline. Public-safe.
- GET /api/v1/new: Recently added emoji records from the canonical data layer. Public-safe.
- POST /api/v1/score: Score an existing emoji or proposal payload. Public-safe.
- GET /api/v1/score/{emojiSlug}: Reserved public score lookup; use POST /api/v1/score for current deterministic scoring. Public-safe.
- POST /api/v1/battle: Compare two emoji scores head-to-head. Public-safe.
- POST /api/v1/sentiment/score: Score sentiment and symbolic meaning. Public-safe.
- POST /api/v1/combinations/score: Score emoji combinations and phrase+emoji expressions. Public-safe.
- POST /api/v1/proposals/score: Score a Unicode-style proposal. Public-safe.
- GET /api/v1/proposals: List ephemeral public-safe proposal results in this runtime. Public-safe.
- POST /api/v1/proposals: Protected server persistence hook backed by the configured database. Protected by PLATPHORM_API_KEY.
- GET /api/v1/proposals/{id}: Get a public-safe proposal score or stored proposal metadata when available. Public-safe.
- POST /api/v1/proposals/{id}/score: Score a stored proposal by id or slug. Public-safe.
- POST /api/v1/proposals/{id}/export: Export proposal markdown when result is available. Public-safe.
- GET /api/v1/proposals/{id}/download: Download proposal markdown when result is available. Public-safe.
- GET /api/v1/proposal-criteria: List versioned proposal criteria from the scoring registry. Public-safe.
- GET /api/v1/score-dimensions: List versioned score dimensions from the scoring registry. Public-safe.
- POST /api/v1/model/proposal-draft: Protected model-ready proposal writing adapter. Protected by PLATPHORM_API_KEY.
- POST /api/v1/model/improve-proposal: Protected model-ready improvement adapter. Protected by PLATPHORM_API_KEY.
- POST /api/v1/model/explain-sentiment: Protected model-ready sentiment explanation adapter. Protected by PLATPHORM_API_KEY.
- POST /api/v1/model/image-prompt: Protected model-ready image prompt adapter. Protected by PLATPHORM_API_KEY.
- POST /api/v1/model/accessibility-review: Protected model-ready accessibility review adapter. Protected by PLATPHORM_API_KEY.
- GET /api/v1/unicode/snapshot: Unicode data snapshot metadata. Public-safe.
- POST /api/v1/unicode/refresh: Protected refresh hook. Protected by PLATPHORM_API_KEY.
- POST /api/v1/import/unicode: Protected Unicode import hook. Protected by PLATPHORM_API_KEY.
- POST /api/v1/import/emoji: Protected emoji import hook. Protected by PLATPHORM_API_KEY.
- POST /api/v1/data/rebuild-search: Protected search index rebuild hook. Protected by PLATPHORM_API_KEY.
- POST /api/v1/data/recalculate-scores: Protected score recalculation hook. Protected by PLATPHORM_API_KEY.
- GET /api/docs: Machine-readable API docs. Public-safe.
- GET /openapi.yaml: OpenAPI 3.1 specification. Public-safe.
- GET /openapi.json: OpenAPI 3.1 specification as JSON. Public-safe.
- GET /api/mcp: MCP metadata and usage. Public-safe.
- POST /api/mcp: MCP JSON-RPC 2.0 endpoint. Public-safe.
- GET /data/emoji: Read public-safe canonical emoji records from the Emoji Score data layer. Public-safe.
- GET /data/unicode: Read public-safe canonical unicode records from the Emoji Score data layer. Public-safe.
- GET /data/categories: Read public-safe canonical categories records from the Emoji Score data layer. Public-safe.
- GET /data/groups: Read public-safe canonical groups records from the Emoji Score data layer. Public-safe.
- GET /data/subgroups: Read public-safe canonical subgroups records from the Emoji Score data layer. Public-safe.
- GET /data/keywords: Read public-safe canonical keywords records from the Emoji Score data layer. Public-safe.
- GET /data/aliases: Read public-safe canonical aliases records from the Emoji Score data layer. Public-safe.
- GET /data/timeline: Read public-safe canonical timeline records from the Emoji Score data layer. Public-safe.
- GET /data/proposals: Read public-safe canonical proposals records from the Emoji Score data layer. Public-safe.
- GET /data/scoring: Read public-safe canonical scoring records from the Emoji Score data layer. Public-safe.
- GET /data/sentiment: Read public-safe canonical sentiment records from the Emoji Score data layer. Public-safe.
- GET /data/images: Read public-safe canonical images records from the Emoji Score data layer. Public-safe.
- GET /data/sources: Read public-safe canonical sources records from the Emoji Score data layer. Public-safe.
- GET /data/search: Read public-safe canonical search records from the Emoji Score data layer. Public-safe.
- GET /data/imports: Read public-safe canonical imports records from the Emoji Score data layer. Public-safe.
- GET /data/discovery: Read public-safe canonical discovery records from the Emoji Score data layer. Public-safe.
- GET /data/fixtures: Read public-safe canonical fixtures records from the Emoji Score data layer. Public-safe.
- GET /data/snapshots: Read public-safe canonical snapshots records from the Emoji Score data layer. Public-safe.

## MCP

- GET /api/mcp: MCP metadata and usage.
- POST /api/mcp: JSON-RPC 2.0 for initialize, ping, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get.
- 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.
- 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.
- 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.

## Model State

unavailable: No server-side model provider is configured.

## No-Fake-Data Policy

Emoji scores, sentiment scores, proposal scores, timeline data, exports, model state, MCP tools, and discovery files are deterministic or explicitly degraded. No generated image is claimed unless a real backend generation call completes.