`aws_lookup_primitive`

Look up an AWS primitive type by its identifier.

Returns the curated knowledge chunks that document a single AWS primitive — its purpose, inputs, outputs, common pitfalls, and any facets attached to it. Use this when you have a type_id (or a primitive name) and want the prose reference for it.

Family: knowledge
Source: cbx-mcp/src/cbx_mcp/tools/knowledge.py::aws_lookup_primitive
Backend: GET /v1/knowledge/aws/primitives/{type_id}

Input schema

{
  "type": "object",
  "properties": {
    "type_id": {
      "type": "string",
      "description": "Primitive identifier, e.g. 'aws:s3/bucket@v1' or a short name like 's3_bucket'."
    }
  },
  "required": ["type_id"]
}

type_id is forwarded verbatim into the backend path. The backend accepts either a fully qualified versioned id (aws:s3/bucket@v1) or a primitive short name; resolution is server-side.

Output schema

On success the tool returns the backend's PublicKnowledgeResponse wrapped in the standard MCP envelope:

{
  "type": "object",
  "properties": {
    "isError": { "type": "boolean" },
    "result": {
      "type": "object",
      "properties": {
        "kb_version": { "type": "integer" },
        "chunks": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "doc_path":    { "type": "string" },
              "heading":     { "type": ["string", "null"] },
              "chunk_text":  { "type": "string" },
              "chunk_index": { "type": "integer" },
              "token_count": { "type": "integer" },
              "category":    { "type": "string" },
              "type_ids":    { "type": "array", "items": { "type": "string" } },
              "tags":        { "type": "array", "items": { "type": "string" } }
            },
            "required": [
              "doc_path",
              "chunk_text",
              "chunk_index",
              "token_count",
              "category"
            ]
          }
        }
      },
      "required": ["kb_version"]
    },
    "error": { "type": "string" }
  },
  "required": ["isError"]
}

chunks is an ordered list of KnowledgeChunkResponse objects ranked by relevance to the requested type_id. kb_version identifies the knowledge-base snapshot the chunks were drawn from — pin a downstream cache to this value when reproducibility matters.

Example call

{
  "name": "aws_lookup_primitive",
  "arguments": {
    "type_id": "aws:s3/bucket@v1"
  }
}

Example result

Illustrative — real responses contain many more chunks and richer prose drawn from the curated AWS knowledge base.

{
  "isError": false,
  "result": {
    "kb_version": 12,
    "chunks": [
      {
        "doc_path": "resources/aws/primitives/s3_bucket/overview.md",
        "heading": "S3 Bucket",
        "chunk_text": "An S3 bucket is a globally namespaced container for object storage...",
        "chunk_index": 0,
        "token_count": 184,
        "category": "primitive_overview",
        "type_ids": ["aws:s3/bucket@v1"],
        "tags": ["storage", "static-site"]
      }
    ]
  }
}