{
  "schemaVersion": 1,
  "id": "coding-mcp-builder-2026-10-04",
  "skillSlug": "mcp-builder",
  "title": "Inventory MCP: actual stdio client calls",
  "environment": "Codex agent; Node.js 24.13.0, Python 3.12.3, Linux 7.0.0-1010-aws. Exact model version not exposed.",
  "executor": {
    "agent": "/root/data_review",
    "product": "Codex",
    "exactModelVersion": null,
    "sourceUse": "Pinned instructions read and explicitly applied in this agent session; automatic skill selection was not tested."
  },
  "method": "Implemented a local TypeScript server with the official MCP SDK, compiled it, and launched it as a separate stdio process from an SDK client. Captured the actual initialize, tools/list and tools/call messages.",
  "checks": [
    "TypeScript compilation passed with SDK 1.32.0 and Zod 4.6.5.",
    "Eight protocol tests passed: discovery, A001=7, B002=0, C003 not found, three invalid-input cases and an unchanged repeated read.",
    "The actual handshake negotiated protocol 2025-11-25; server stderr was empty in the saved transcript."
  ],
  "limitations": [
    "The inventory is a synthetic local fixture; no external inventory service or production credentials were used.",
    "Authentication, deployment, production rate limits, MCP Inspector UI and model tool selection were not tested.",
    "This does not compare the agent with a no-skill baseline.",
    "The executor was Codex in this conversation; the exact model version was not exposed.",
    "These examples do not represent independent human users, customer outcomes or a compatibility certification."
  ],
  "sources": [
    {
      "skill": "mcp-builder",
      "repository": "anthropics/skills",
      "revision": "8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4",
      "url": "https://raw.githubusercontent.com/anthropics/skills/8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4/skills/mcp-builder/SKILL.md",
      "sha256": "0f4592dcb53cf2b5d6b7febee6b4152018b565551a1c29e3c612f57b218ab295"
    },
    {
      "path": "mcp-builder/reference/mcp_best_practices.md",
      "repository": "anthropics/skills",
      "revision": "8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4",
      "url": "https://raw.githubusercontent.com/anthropics/skills/8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4/skills/mcp-builder/reference/mcp_best_practices.md",
      "sha256": "80fb4369a349447cf18ecdd7494fe7938b6065377e9f08c077cec411093a3007"
    },
    {
      "path": "mcp-builder/reference/node_mcp_server.md",
      "repository": "anthropics/skills",
      "revision": "8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4",
      "url": "https://raw.githubusercontent.com/anthropics/skills/8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4/skills/mcp-builder/reference/node_mcp_server.md",
      "sha256": "c3ba35a4f599dd53be9c6555ae72c19a7bf412cd5426576c2c08d42755482c66"
    },
    {
      "path": "mcp-builder/reference/evaluation.md",
      "repository": "anthropics/skills",
      "revision": "8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4",
      "url": "https://raw.githubusercontent.com/anthropics/skills/8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4/skills/mcp-builder/reference/evaluation.md",
      "sha256": "8c99479f8a2d22a636c38e274537aac3610879e26f34e0709825077c4576f427"
    }
  ],
  "recipe": {
    "slug": "mcp-builder",
    "sourceUrl": "https://github.com/anthropics/skills/blob/8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4/skills/mcp-builder/SKILL.md",
    "sourceRevision": "8a1541c4a3ffa5a20a5a91de0dcf3f0bab1d1ef4",
    "firstTask": "Build a local inventory lookup with one successful and one missing-item case.",
    "firstPrompt": "Use mcp-builder to design a local read-only inventory MCP server. The fixture has SKU A001 with 7 units and B002 with 0 units. Expose one lookup tool with a typed SKU input. Return an explicit not-found result for C003. Choose an SDK, explain the transport, implement the tool, and show how to invoke all three cases with an MCP client. Do not claim the server works until those calls have run.",
    "expectedResult": "A minimal local MCP server, clear startup instructions, and three invocation cases with distinguishable results.",
    "acceptanceCriteria": [
      "A001 returns 7 and B002 returns 0; missing C003 is distinct from zero stock.",
      "Invalid input is handled predictably, with no production credential required.",
      "A client invocation demonstrates the tool interface, not just a direct function unit test."
    ]
  },
  "manifestUrl": "/examples/runs/mcp-builder/manifest.json",
  "artifacts": [
    {
      "label": "Run report",
      "href": "/examples/runs/mcp-builder/report.md"
    },
    {
      "label": "Sources, snapshots and original evidence (ZIP)",
      "href": "/examples/runs/mcp-builder/source-and-evidence.zip"
    },
    {
      "label": "Executed command ledger",
      "href": "/examples/runs/mcp-builder/commands.jsonl"
    },
    {
      "label": "Actual protocol transcript",
      "href": "/examples/runs/mcp-builder/client-transcript.json"
    },
    {
      "label": "Server source",
      "href": "/examples/runs/mcp-builder/src/server.ts.txt"
    },
    {
      "label": "Client tests",
      "href": "/examples/runs/mcp-builder/client.test.mjs.txt"
    },
    {
      "label": "Exact dependency lockfile",
      "href": "/examples/runs/mcp-builder/package-lock.json"
    }
  ],
  "protocol": {
    "transport": "stdio",
    "negotiatedVersion": "2025-11-25",
    "sdk": "@modelcontextprotocol/sdk@1.32.0",
    "specification": "https://modelcontextprotocol.io/specification/2025-11-25/server/tools"
  },
  "commands": [
    {
      "label": "install-dependencies",
      "command": [
        "npm",
        "install",
        "--ignore-scripts",
        "--no-audit",
        "--no-fund"
      ],
      "cwd": "/tmp/opx-coding-skill-runs/mcp-builder",
      "startedAt": "2026-10-04T14:48:12.456374+00:00",
      "finishedAt": "2026-10-04T14:48:19.659359+00:00",
      "exitCode": 0,
      "expectedExit": 0,
      "expectationMet": true,
      "stdout": "logs/install-dependencies.stdout.txt",
      "stderr": "logs/install-dependencies.stderr.txt",
      "stdoutSha256": "7547f85c86e40e9cc14a86e146bd1a39e93373edc8b191d507ffd8118f734e10",
      "stderrSha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    {
      "label": "build",
      "command": [
        "npm",
        "run",
        "build"
      ],
      "cwd": "/tmp/opx-coding-skill-runs/mcp-builder",
      "startedAt": "2026-10-04T14:49:54.923105+00:00",
      "finishedAt": "2026-10-04T14:49:57.412104+00:00",
      "exitCode": 0,
      "expectedExit": 0,
      "expectationMet": true,
      "stdout": "logs/build.stdout.txt",
      "stderr": "logs/build.stderr.txt",
      "stdoutSha256": "926e951fa61c56e6f858e03498e15d703d41226dcac4e6065392d56d9ec2f180",
      "stderrSha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    {
      "label": "client-invocations",
      "command": [
        "npm",
        "test"
      ],
      "cwd": "/tmp/opx-coding-skill-runs/mcp-builder",
      "startedAt": "2026-10-04T14:51:49.023003+00:00",
      "finishedAt": "2026-10-04T14:51:50.260479+00:00",
      "exitCode": 0,
      "expectedExit": 0,
      "expectationMet": true,
      "stdout": "logs/client-invocations.stdout.txt",
      "stderr": "logs/client-invocations.stderr.txt",
      "stdoutSha256": "f972bf8c26053f2c69a8ca08cc9ffbfcfc9b0c8f6f6bf9dbd9e938c96a02b2dc",
      "stderrSha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    {
      "label": "protocol-transcript",
      "command": [
        "npm",
        "test"
      ],
      "cwd": "/tmp/opx-coding-skill-runs/mcp-builder",
      "startedAt": "2026-10-04T14:55:22.781916+00:00",
      "finishedAt": "2026-10-04T14:55:23.813251+00:00",
      "exitCode": 0,
      "expectedExit": 0,
      "expectationMet": true,
      "stdout": "logs/protocol-transcript.stdout.txt",
      "stderr": "logs/protocol-transcript.stderr.txt",
      "stdoutSha256": "6a486431f0d02d13fb806b2cffc4d8ea2502320356df90b2d38379542ffc1037",
      "stderrSha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    }
  ],
  "startedAt": "2026-10-04T14:48:12.456374+00:00",
  "executedAt": "2026-10-04T14:55:23.813251+00:00",
  "files": [
    {
      "path": "client-transcript.json",
      "bytes": 13816,
      "sha256": "6955030195ab0bffd908b52e1e8a24afff7072c111468923621191256e6a796f"
    },
    {
      "path": "client.test.mjs.txt",
      "bytes": 3554,
      "sha256": "ac924419b26d0d4e487e7443f26edde5ca43956437537115c992278972959629"
    },
    {
      "path": "commands.jsonl",
      "bytes": 2148,
      "sha256": "a715a53ff54dcf3addbe46df2bd3dd284a914520981cd0d8c192b1685b7ffc23"
    },
    {
      "path": "dist/server.js.txt",
      "bytes": 1386,
      "sha256": "93661d3ee002645ef12f96064e328357becf82054337c562528f1bbb5d4106a3"
    },
    {
      "path": "logs/build.stderr.txt",
      "bytes": 0,
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    {
      "path": "logs/build.stdout.txt",
      "bytes": 43,
      "sha256": "926e951fa61c56e6f858e03498e15d703d41226dcac4e6065392d56d9ec2f180"
    },
    {
      "path": "logs/client-invocations.stderr.txt",
      "bytes": 0,
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    {
      "path": "logs/client-invocations.stdout.txt",
      "bytes": 1383,
      "sha256": "f972bf8c26053f2c69a8ca08cc9ffbfcfc9b0c8f6f6bf9dbd9e938c96a02b2dc"
    },
    {
      "path": "logs/install-dependencies.stderr.txt",
      "bytes": 0,
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    {
      "path": "logs/install-dependencies.stdout.txt",
      "bytes": 25,
      "sha256": "7547f85c86e40e9cc14a86e146bd1a39e93373edc8b191d507ffd8118f734e10"
    },
    {
      "path": "logs/protocol-transcript.stderr.txt",
      "bytes": 0,
      "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
    },
    {
      "path": "logs/protocol-transcript.stdout.txt",
      "bytes": 1385,
      "sha256": "6a486431f0d02d13fb806b2cffc4d8ea2502320356df90b2d38379542ffc1037"
    },
    {
      "path": "package-lock.json",
      "bytes": 43669,
      "sha256": "23e5c0e40c7cc131e4041d21769800b5fc35ff3c73e84a44c8aa9b521e4de76b"
    },
    {
      "path": "package.json",
      "bytes": 408,
      "sha256": "b97856510d8ffb39333adff33af2ffba926025cff6415194b7df98b3a844b6ef"
    },
    {
      "path": "recipe.json",
      "bytes": 1165,
      "sha256": "8272fb2c395c09143218e79282b36608a9c392a2d4f60c12c59743b6ad91012f"
    },
    {
      "path": "report.md",
      "bytes": 2450,
      "sha256": "9b56a344e59c3a14d5fab099201af5702df2c675835422c0a590b48d08937f7c"
    },
    {
      "path": "source-and-evidence.zip",
      "bytes": 21882,
      "sha256": "cd1e4a73aeb3f5333b68344bb89bfbc6f1c2af8a8094a1686b90f1af7f530e0b"
    },
    {
      "path": "sources.json",
      "bytes": 1551,
      "sha256": "a69d5a5eaff50e79c89b61b1c45b32caea0331c370e3dcabc7e8cbfee46297b3"
    },
    {
      "path": "src/server.ts.txt",
      "bytes": 1423,
      "sha256": "3448b42d084b5abc3b26325860fff53f5104d03600b94abf27a3fa3f983f55a5"
    },
    {
      "path": "tsconfig.json",
      "bytes": 214,
      "sha256": "c5d2990ac0e2d8aed365e24173c2ad3d0fd1b81a4c7f6e2b0773e6000070b825"
    }
  ]
}
