# MONMONMON

> Tattoo monsters by Peelander Yellow, digital collectibles on Solana, and two distinct browser card games. Hidden Feelings is a free five-card secret-feeling game; the original MONMONMON game has a separate browser flow.

Public reads require no API key. Hidden Feelings uses the monmon_duel session cookie or a scoped bearer token; owned cards additionally require the wallet owner's message signature. Preserve hidden information. Do not create games or make moves unless the user asks to play. The free card API covers the curated 25, not the complete collection.

## Guides
- [Agent guide](https://monmonmon.art/docs/agents.md): capabilities, authentication and rate limits.
- [API guide](https://monmonmon.art/docs/api.md): executable examples for real gameplay.
- [Hidden Feelings](https://monmonmon.art/docs/hidden-feelings.md): five cards, ten feelings, alternating turns.
- [Original game](https://monmonmon.art/docs/original-game.md): browser flow and practice.
- [Public skill](https://monmonmon.art/skill.md): concise instructions for agents.

## APIs
- [OpenAPI](https://monmonmon.art/openapi.json): public JSON reads and Hidden Feelings actions.
- [Free cards](https://monmonmon.art/api/agent/cards): curated previews and default team.
- [Leaderboard](https://monmonmon.art/api/leaderboard): full-history totals, top 25, recent 25.
- [News](https://monmonmon.art/api/agent/news): story metadata and Markdown by id.
- [MCP discovery](https://monmonmon.art/.well-known/mcp.json): public read-only tools and resources.
- [API catalog](https://monmonmon.art/.well-known/api-catalog): specifications and documentation.

## More
- [Explore](https://monmonmon.art/explore): the wider collection with letter and color filters.
- [RSS](https://monmonmon.art/feed.xml): news with dates and artwork.
- [Status](https://monmonmon.art/api/agent/status): API availability.

## Agent gameplay allowance

All agents share 50 distinct Hidden Feelings matches per UTC day through /api/agent/duel and WebMCP. Agent creates require an Idempotency-Key and a persistent cookie session. Honor AGENT_DAILY_GAME_LIMIT and Retry-After; do not try to evade the allowance. Existing admitted matches may finish.

## Agent-native interfaces

- [Persistent session](https://monmonmon.art/api/agent/session): private context across requests.
- [Scoped token metadata](https://monmonmon.art/api/agent/tokens): revocable, expiring credentials with explicit permissions.
- [Start-game intent](https://monmonmon.art/api/agent/intents/start-game): prepare a free team and start a real game when asked.
- [Isolated sandbox](https://monmonmon.art/api/agent/sandbox): encrypted solo simulation state without game-database or leaderboard writes.

Read x-consequence in OpenAPI before acting. X-Request-ID correlates responses with sanitized application logs. Scoped tokens and alternate intent routes share the existing production quota.