Skip to main content
Glama

오늘냥이 (Oneul Nyangi)

공개 기록 보기

get_public_post
Read-onlyIdempotent

공개 기록·사진·반응·고양이 프로필과 관련 기록을 조회합니다. show_cat_photos/search_public_content에서 받은 postId를 사용하세요. cat.id로 get_cat_profile을 호출하면 최근 기록으로 이어집니다. relatedPosts.relation/matchedFacets는 같은 고양이·품종 또는 로컬 분석 속성의 공통점을 설명하며 이미지 임베딩 점수나 감정의 확정 판정이 아닙니다.

Input Schema

NameRequiredDescriptionDefault
fieldsNo선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다.
postIdYes게시물 UUID

Output Schema

NameRequiredDescriptionDefault
idNo
catNo
urlNo
codeNo
tagsNo
catIdNo
errorNo
imageNo
catUrlNo
imagesNo
webUrlNo
captionNo
imageUrlNo
createdAtNo
discoveryNo
reactionsNo
thumbnailNo
recordDateNo
relatedCatNo
relatedPostsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • addedInput schema / examples
      Added value: +[
      +  {
      +    "postId": "531d8700-1d25-4d2a-961c-b5a85c28c357"
      +  }
      +]
    • changedInput schema / properties / fields / items / enum
      Previous value: -[
      -  "id",
      -  "url",
      -  "webUrl",
      -  "caption",
      -  "tags",
      -  "recordDate",
      -  "image",
      -  "imageUrl",
      -  "thumbnail",
      -  "catId",
      -  "catUrl",
      -  "reactions.likes",
      -  "reactions.cute",
      -  "reactions.funny",
      -  "reactions.total",
      -  "createdAt",
      -  "images",
      -  "cat.id",
      -  "cat.url",
      -  "cat.webUrl",
      -  "cat.name",
      -  "cat.breed",
      -  "cat.breedId",
      -  "cat.intro",
      -  "cat.avatar",
      -  "cat.imageUrl",
      -  "cat.thumbnail",
      -  "relatedCat.id",
      -  "relatedCat.url",
      -  "relatedCat.webUrl",
      -  "relatedCat.name",
      -  "relatedCat.breed",
      -  "relatedCat.breedId",
      -  "relatedCat.intro",
      -  "relatedCat.avatar",
      -  "relatedCat.imageUrl",
      -  "relatedCat.thumbnail",
      -  "relatedPosts.id",
      -  "relatedPosts.url",
      -  "relatedPosts.webUrl",
      -  "relatedPosts.caption",
      -  "relatedPosts.tags",
      -  "relatedPosts.recordDate",
      -  "relatedPosts.image",
      -  "relatedPosts.imageUrl",
      -  "relatedPosts.thumbnail",
      -  "relatedPosts.catId",
      -  "relatedPosts.catUrl",
      -  "relatedPosts.reactions.likes",
      -  "relatedPosts.reactions.cute",
      -  "relatedPosts.reactions.funny",
      -  "relatedPosts.reactions.total",
      -  "relatedPosts.relation"
      -]New value: +[
      +  "id",
      +  "url",
      +  "webUrl",
      +  "caption",
      +  "tags",
      +  "recordDate",
      +  "image",
      +  "imageUrl",
      +  "thumbnail",
      +  "catId",
      +  "catUrl",
      +  "reactions.likes",
      +  "reactions.cute",
      +  "reactions.funny",
      +  "reactions.total",
      +  "discovery.source",
      +  "discovery.coverage",
      +  "discovery.confidence",
      +  "discovery.observedAt",
      +  "discovery.attributes.breed",
      +  "discovery.attributes.coatColor",
      +  "discovery.attributes.pose",
      +  "discovery.attributes.activity",
      +  "discovery.attributes.scene",
      +  "discovery.attributes.mood",
      +  "createdAt",
      +  "images",
      +  "cat.id",
      +  "cat.url",
      +  "cat.webUrl",
      +  "cat.name",
      +  "cat.breed",
      +  "cat.breedId",
      +  "cat.intro",
      +  "cat.avatar",
      +  "cat.imageUrl",
      +  "cat.thumbnail",
      +  "relatedCat.id",
      +  "relatedCat.url",
      +  "relatedCat.webUrl",
      +  "relatedCat.name",
      +  "relatedCat.breed",
      +  "relatedCat.breedId",
      +  "relatedCat.intro",
      +  "relatedCat.avatar",
      +  "relatedCat.imageUrl",
      +  "relatedCat.thumbnail",
      +  "relatedPosts.id",
      +  "relatedPosts.url",
      +  "relatedPosts.webUrl",
      +  "relatedPosts.caption",
      +  "relatedPosts.tags",
      +  "relatedPosts.recordDate",
      +  "relatedPosts.image",
      +  "relatedPosts.imageUrl",
      +  "relatedPosts.thumbnail",
      +  "relatedPosts.catId",
      +  "relatedPosts.catUrl",
      +  "relatedPosts.reactions.likes",
      +  "relatedPosts.reactions.cute",
      +  "relatedPosts.reactions.funny",
      +  "relatedPosts.reactions.total",
      +  "relatedPosts.discovery.source",
      +  "relatedPosts.discovery.coverage",
      +  "relatedPosts.discovery.confidence",
      +  "relatedPosts.discovery.observedAt",
      +  "relatedPosts.discovery.attributes.breed",
      +  "relatedPosts.discovery.attributes.coatColor",
      +  "relatedPosts.discovery.attributes.pose",
      +  "relatedPosts.discovery.attributes.activity",
      +  "relatedPosts.discovery.attributes.scene",
      +  "relatedPosts.discovery.attributes.mood",
      +  "relatedPosts.relation",
      +  "relatedPosts.matchedFacets",
      +  "relatedPosts.matchScore"
      +]
    • addedOutput schema / properties / discovery
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "attributes": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "activity": {
      +          "items": {
      +            "enum": [
      +              "sleeping",
      +              "resting",
      +              "playing",
      +              "eating",
      +              "grooming",
      +              "walking",
      +              "watching",
      +              "stretching"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        },
      +        "breed": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "coatColor": {
      +          "items": {
      +            "enum": [
      +              "white",
      +              "black",
      +              "brown",
      +              "gray",
      +              "orange",
      +              "cream",
      +              "tabby",
      +              "calico",
      +              "tuxedo"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        },
      +        "mood": {
      +          "items": {
      +            "enum": [
      +              "relaxed",
      +              "sleepy",
      +              "playful",
      +              "alert",
      +              "curious"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        },
      +        "pose": {
      +          "items": {
      +            "enum": [
      +              "sitting",
      +              "standing",
      +              "lying",
      +              "loaf",
      +              "stretching",
      +              "curled",
      +              "belly_up"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        },
      +        "scene": {
      +          "items": {
      +            "enum": [
      +              "indoors",
      +              "outdoors",
      +              "window",
      +              "cat_tree",
      +              "sofa",
      +              "bed",
      +              "floor",
      +              "box",
      +              "garden"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "confidence": {
      +      "maximum": 1,
      +      "minimum": 0.8,
      +      "type": "number"
      +    },
      +    "coverage": {
      +      "enum": [
      +        "photos",
      +        "sampled",
      +        "poster"
      +      ],
      +      "type": "string"
      +    },
      +    "observedAt": {
      +      "type": "string"
      +    },
      +    "source": {
      +      "enum": [
      +        "local_vision"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / relatedPosts / items / properties / discovery
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "attributes": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "activity": {
      +          "items": {
      +            "enum": [
      +              "sleeping",
      +              "resting",
      +              "playing",
      +              "eating",
      +              "grooming",
      +              "walking",
      +              "watching",
      +              "stretching"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        },
      +        "breed": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "coatColor": {
      +          "items": {
      +            "enum": [
      +              "white",
      +              "black",
      +              "brown",
      +              "gray",
      +              "orange",
      +              "cream",
      +              "tabby",
      +              "calico",
      +              "tuxedo"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        },
      +        "mood": {
      +          "items": {
      +            "enum": [
      +              "relaxed",
      +              "sleepy",
      +              "playful",
      +              "alert",
      +              "curious"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        },
      +        "pose": {
      +          "items": {
      +            "enum": [
      +              "sitting",
      +              "standing",
      +              "lying",
      +              "loaf",
      +              "stretching",
      +              "curled",
      +              "belly_up"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        },
      +        "scene": {
      +          "items": {
      +            "enum": [
      +              "indoors",
      +              "outdoors",
      +              "window",
      +              "cat_tree",
      +              "sofa",
      +              "bed",
      +              "floor",
      +              "box",
      +              "garden"
      +            ],
      +            "type": "string"
      +          },
      +          "maxItems": 4,
      +          "type": "array",
      +          "uniqueItems": true
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "confidence": {
      +      "maximum": 1,
      +      "minimum": 0.8,
      +      "type": "number"
      +    },
      +    "coverage": {
      +      "enum": [
      +        "photos",
      +        "sampled",
      +        "poster"
      +      ],
      +      "type": "string"
      +    },
      +    "observedAt": {
      +      "type": "string"
      +    },
      +    "source": {
      +      "enum": [
      +        "local_vision"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / relatedPosts / items / properties / matchScore
      Added value: +{
      +  "maximum": 28,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / relatedPosts / items / properties / matchedFacets
      Added value: +{
      +  "items": {
      +    "enum": [
      +      "coatColor",
      +      "pose",
      +      "activity",
      +      "scene",
      +      "mood"
      +    ],
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / relatedPosts / items / properties / relation / enum
      Added value: +[
      +  "same_cat",
      +  "same_breed",
      +  "shared_attributes"
      +]
  2. Changed2 schema fields changed
    • changedInput schema / properties / fields / items / enum
      Previous value: -[
      -  "id",
      -  "url",
      -  "caption",
      -  "tags",
      -  "recordDate",
      -  "image",
      -  "createdAt",
      -  "images",
      -  "cat.id",
      -  "cat.url",
      -  "cat.name",
      -  "cat.breed",
      -  "cat.breedId"
      -]New value: +[
      +  "id",
      +  "url",
      +  "webUrl",
      +  "caption",
      +  "tags",
      +  "recordDate",
      +  "image",
      +  "imageUrl",
      +  "thumbnail",
      +  "catId",
      +  "catUrl",
      +  "reactions.likes",
      +  "reactions.cute",
      +  "reactions.funny",
      +  "reactions.total",
      +  "createdAt",
      +  "images",
      +  "cat.id",
      +  "cat.url",
      +  "cat.webUrl",
      +  "cat.name",
      +  "cat.breed",
      +  "cat.breedId",
      +  "cat.intro",
      +  "cat.avatar",
      +  "cat.imageUrl",
      +  "cat.thumbnail",
      +  "relatedCat.id",
      +  "relatedCat.url",
      +  "relatedCat.webUrl",
      +  "relatedCat.name",
      +  "relatedCat.breed",
      +  "relatedCat.breedId",
      +  "relatedCat.intro",
      +  "relatedCat.avatar",
      +  "relatedCat.imageUrl",
      +  "relatedCat.thumbnail",
      +  "relatedPosts.id",
      +  "relatedPosts.url",
      +  "relatedPosts.webUrl",
      +  "relatedPosts.caption",
      +  "relatedPosts.tags",
      +  "relatedPosts.recordDate",
      +  "relatedPosts.image",
      +  "relatedPosts.imageUrl",
      +  "relatedPosts.thumbnail",
      +  "relatedPosts.catId",
      +  "relatedPosts.catUrl",
      +  "relatedPosts.reactions.likes",
      +  "relatedPosts.reactions.cute",
      +  "relatedPosts.reactions.funny",
      +  "relatedPosts.reactions.total",
      +  "relatedPosts.relation"
      +]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "caption": {
      +      "type": "string"
      +    },
      +    "cat": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "avatar": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        },
      +        "breed": {
      +          "type": "string"
      +        },
      +        "breedId": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "imageUrl": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        },
      +        "intro": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "thumbnail": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        },
      +        "url": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        },
      +        "webUrl": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "catId": {
      +      "type": "string"
      +    },
      +    "catUrl": {
      +      "pattern": "^https?://",
      +      "type": "string"
      +    },
      +    "code": {
      +      "type": "string"
      +    },
      +    "createdAt": {
      +      "type": "string"
      +    },
      +    "error": {
      +      "type": "string"
      +    },
      +    "id": {
      +      "type": "string"
      +    },
      +    "image": {
      +      "pattern": "^https?://",
      +      "type": "string"
      +    },
      +    "imageUrl": {
      +      "pattern": "^https?://",
      +      "type": "string"
      +    },
      +    "images": {
      +      "items": {
      +        "pattern": "^https?://",
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "reactions": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "cute": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "funny": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "likes": {
      +          "minimum": 0,
      +          "type": "integer"
      +        },
      +        "total": {
      +          "minimum": 0,
      +          "type": "integer"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "recordDate": {
      +      "type": "string"
      +    },
      +    "relatedCat": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "avatar": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        },
      +        "breed": {
      +          "type": "string"
      +        },
      +        "breedId": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "imageUrl": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        },
      +        "intro": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "thumbnail": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        },
      +        "url": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        },
      +        "webUrl": {
      +          "pattern": "^https?://",
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "relatedPosts": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "caption": {
      +            "type": "string"
      +          },
      +          "catId": {
      +            "type": "string"
      +          },
      +          "catUrl": {
      +            "pattern": "^https?://",
      +            "type": "string"
      +          },
      +          "id": {
      +            "type": "string"
      +          },
      +          "image": {
      +            "pattern": "^https?://",
      +            "type": "string"
      +          },
      +          "imageUrl": {
      +            "pattern": "^https?://",
      +            "type": "string"
      +          },
      +          "reactions": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "cute": {
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "funny": {
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "likes": {
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "total": {
      +                "minimum": 0,
      +                "type": "integer"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "recordDate": {
      +            "type": "string"
      +          },
      +          "relation": {
      +            "type": "string"
      +          },
      +          "tags": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "thumbnail": {
      +            "pattern": "^https?://",
      +            "type": "string"
      +          },
      +          "url": {
      +            "pattern": "^https?://",
      +            "type": "string"
      +          },
      +          "webUrl": {
      +            "pattern": "^https?://",
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "tags": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "thumbnail": {
      +      "pattern": "^https?://",
      +      "type": "string"
      +    },
      +    "url": {
      +      "pattern": "^https?://",
      +      "type": "string"
      +    },
      +    "webUrl": {
      +      "pattern": "^https?://",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • addedInput schema / properties / fields
      Added value: +{
      +  "description": "선택. 필요한 공개 결과 필드만 반환합니다. 배열 안 필드는 photos.url처럼 지정합니다.",
      +  "items": {
      +    "enum": [
      +      "id",
      +      "url",
      +      "caption",
      +      "tags",
      +      "recordDate",
      +      "image",
      +      "createdAt",
      +      "images",
      +      "cat.id",
      +      "cat.url",
      +      "cat.name",
      +      "cat.breed",
      +      "cat.breedId"
      +    ],
      +    "type": "string"
      +  },
      +  "maxItems": 32,
      +  "minItems": 1,
      +  "type": "array",
      +  "uniqueItems": true
      +}
  4. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description still adds genuine behavioral context by warning that relatedPosts.relation/matchedFacets are commonality signals, not image embedding scores or definitive emotion judgments — a caveat an agent could not derive from structured fields. It does not cover failure modes (invalid or non-public postId), which keeps it from a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and input-source instruction are front-loaded in the first two sentences, followed by the follow-on call and the interpretation caveat. Four dense sentences with no filler, though the final sentence is long enough that a reader must parse it carefully.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, and annotations carry the safety profile; the description correctly fills the remaining gaps (input provenance, follow-on call, semantics of ambiguous derived fields). The only missing piece is behavior on missing/private posts.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so a baseline of 3 applies, but the description goes beyond the schema by explaining the provenance of postId, how cat.id chains into get_cat_profile, and the intended interpretation of the derived relatedPosts fields selected via the fields array. That meaning is not present in the schema itself.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb (조회) and resource set (공개 기록·사진·반응·고양이 프로필과 관련 기록), and explicitly names the sibling tools (show_cat_photos/search_public_content, get_cat_profile) that produce or consume its inputs, so an agent can distinguish it from them without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit entry conditions ('show_cat_photos/search_public_content에서 받은 postId를 사용하세요') and an explicit follow-on path ('cat.id로 get_cat_profile을 호출하면 최근 기록으로 이어집니다'), which is exactly the when-to-use routing an agent needs. Nothing about sequencing is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources