{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vzwcs7ant7ar","handle":"mcp-agent-kit","url":"https://wellknown.network/agents/mcp-agent-kit","links":{"self":"https://wellknown.network/agents/mcp-agent-kit/record.json","html":"https://wellknown.network/agents/mcp-agent-kit","markdown":"https://wellknown.network/agents/mcp-agent-kit/record.md","api":"https://wellknown.network/api/v1/agents/mcp-agent-kit","status":"https://wellknown.network/api/v1/agents/mcp-agent-kit/status","claim":"https://wellknown.network/agents/mcp-agent-kit/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-agent-kit/claim.json","badge":"https://wellknown.network/agents/mcp-agent-kit/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-agent-kit/history","tools":"https://wellknown.network/api/v1/agents/mcp-agent-kit/tools"},"ard":{"identifier":"urn:air::server:mcp-agent-kit","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-agent-kit","summary":"Production-ready MCP server scaffold with stateless MCP 2026-07-28, A2A Agent Card, and Agent Skill packaging","description":"# mcp-agent-kit\n\n`mcp-agent-kit` is an enterprise-grade scaffolding kit and runtime foundation that enables developers to build, validate, and ship a fully compliant, production-ready Model Context Protocol (MCP) server with Agent-to-Agent (A2A) protocol support and portable Agent Skill (`SKILL.md`) packaging in under 30 minutes. Built entirely with the Python standard library for zero runtime dependencies in the protocol core, it enforces strict stateless MCP specification compliance (version 2026-07-28), deterministic resource listing, schema design validation, dual-era negotiation, and automated tool-to-skill card mapping.\n\n---\n\n## Quick Start (5 Lines)\n\n```bash\npip install mcp-agent-kit\ncreate-mcp-agent my_agent\ncd my_agent\npython validate.py\npython server.py\n```\n\n---\n\n## End-to-End Demo Walkthrough (with Real Outputs)\n\nFollow these step-by-step instructions to scaffold, validate, test, and run an MCP agent end-to-end.\n\n### Step 1: Scaffold a New Agent\nRun the generator CLI to create a new agent (e.g. `demo_agent`):\n\n```bash\npython -m mcp_agent_kit demo_agent --desc \"Use when computing numerical metrics and data summaries. Do not use for unstructured text parsing.\"\n```\n\n**Terminal Output:**\n```text\nScaffolding MCP agent 'demo_agent' into 'demo_agent'...\n✓ Agent 'demo_agent' successfully created in 'demo_agent'.\nNext steps:\n  cd demo_agent\n  python validate.py\n```\n\n---\n\n### Step 2: Run Compliance Validation\nNavigate into the agent directory and execute `validate.py`:\n\n```bash\ncd demo_agent\npython validate.py\n```\n\n**Terminal Output:**\n```text\n✓ MCP server/discover responds correctly\n✓ tools/list is deterministically ordered\n✓ all tool schemas pass design rules\n✓ A2A agent.json is valid\n✓ SKILL.md portable core is valid\n✓ dual-era client probe works against local server\n```\n\n---\n\n### Step 3: Run the Dual-Era Probe Client Test\nVerify client negotiation and tool execution via `client_test.py`:\n\n```bash\npython client_test.py\n```\n\n**Terminal Output:**\n```text\n..\n-----…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","agent","a2a","skill","scaffold"],"pricing":null,"endpoints":[{"url":"pypi:mcp-agent-kit","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-agent-kit","registry":"pypi","observedAt":"2026-10-24T17:29:15.564Z","publishedAt":"2026-10-11T14:29:57.800600Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-agent-kit","url":"https://pypi.org/project/mcp-agent-kit/","firstSeenAt":"2026-10-12T14:24:58.401Z","fetchedAt":"2026-10-24T17:28:00.168Z","normalizedAt":"2026-10-24T17:28:00.168Z"}]},"firstSeenAt":"2026-10-12T14:24:58.401Z","updatedAt":"2026-10-24T17:29:15.564Z"}