{"schema_version":1,"workflow_uuid":"47de10df-654b-43b4-8869-8629119e532d","workflow_title":"mcp-agent — Build AI Agents with MCP Patterns","page_url":"https://tokrepo.com/en/workflows/mcp-agent-build-ai-agents-mcp-patterns-47de10df","raw_url":"https://tokrepo.com/raw/mcp-agent-build-ai-agents-mcp-patterns-47de10df","metadata_url":"https://tokrepo.com/metadata/mcp-agent-build-ai-agents-mcp-patterns-47de10df.json","install_plan_url":"https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid=47de10df-654b-43b4-8869-8629119e532d&target=codex","recommended_install":{"schema_version":1,"status":"stage","policy":"stage_only","install_mode":"stage_only","target":"codex","command":"npx -y tokrepo@latest install 47de10df-654b-43b4-8869-8629119e532d --target codex","dry_run_command":"npx -y tokrepo@latest install 47de10df-654b-43b4-8869-8629119e532d --target codex --dry-run --json","runtime_commands":{"codex":"npx -y tokrepo@latest install 47de10df-654b-43b4-8869-8629119e532d --target codex","gemini":"npx -y tokrepo@latest install 47de10df-654b-43b4-8869-8629119e532d --target gemini","project":"npx -y tokrepo@latest install 47de10df-654b-43b4-8869-8629119e532d"},"prompt":"Install and make this TokRepo asset usable: \"mcp-agent — Build AI Agents with MCP Patterns\".\n\nPage: https://tokrepo.com/en/workflows/mcp-agent-build-ai-agents-mcp-patterns-47de10df\nUUID: 47de10df-654b-43b4-8869-8629119e532d\nTarget adapter: codex\nPolicy/mode: stage_only / stage_only\n\nRead these machine-facing entry points first:\n- metadata: https://tokrepo.com/metadata/mcp-agent-build-ai-agents-mcp-patterns-47de10df.json\n- install contract: https://tokrepo.com/install-contract/mcp-agent-build-ai-agents-mcp-patterns-47de10df.json\n- install plan: https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid=47de10df-654b-43b4-8869-8629119e532d&target=codex\n- raw content: https://tokrepo.com/raw/mcp-agent-build-ai-agents-mcp-patterns-47de10df\n\nCommands:\n- choose the current runtime; do not use unsupported CLI targets.\n- Codex: npx -y tokrepo@latest install 47de10df-654b-43b4-8869-8629119e532d --target codex\n- Gemini CLI: npx -y tokrepo@latest install 47de10df-654b-43b4-8869-8629119e532d --target gemini\n- Claude Code / project agent: run npx -y tokrepo@latest install 47de10df-654b-43b4-8869-8629119e532d from the project root; add `--dry-run --json` first to inspect the plan.\n- add `--dry-run --json` to the chosen command first; after the plan allows it, run the chosen command.\n\nExecution rules:\n1. Run the install command to stage the asset safely.\n2. Read the staged README, install-plan, and entrypoint files.\n3. Activate scripts, MCP config, or global config only after user confirmation.\n4. Verify usability with the install-plan post_verify checks and the asset README.\n\nReport back with changed files, verification result, and how to use the asset next.","next_steps":["Run the install command to stage the asset safely.","Read the staged README, install-plan, and entrypoint files.","Activate scripts, MCP config, or global config only after user confirmation.","Verify usability with the install-plan post_verify checks and the asset README."],"success_check":["The asset is safely staged.","The agent can give clear activation steps from the staged content."]},"agent_metadata":{"asset_kind":"mcp_config","target_tools":["claude_code","codex","cursor","gemini_cli","windsurf"],"install_mode":"stage_only","entrypoint":"mcp-agent — Build AI Agents with MCP Patterns","risk_profile":{"executes_code":false,"modifies_global_config":true,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"dependencies":{"npm":[],"pip":[],"brew":[],"system":[]},"content_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","verification":{"commands":[],"expected_files":["mcp-agent — Build AI Agents with MCP Patterns"]}},"agent_fit":{"target":"codex","score":17,"status":"stage_only","policy":"stage_only","why":["target_tools includes codex","asset_kind mcp_config","install_mode stage_only","policy stage_only","asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","trust established"],"asset_kind":"mcp_config","install_mode":"stage_only"},"trust":{"author_trust_level":"established","verified_publisher":false,"asset_signed_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","signature_status":"hash_only","install_count":0,"report_count":0,"dangerous_capability_badges":["mcp_config","modifies_global_config","stage_only"],"review_status":"unreviewed","signals":["asset has usage views","author has published assets","content hash available"]},"provenance":{"owner_uuid":"8a910281-3180-11f1-9bc6-00163e2b0d79","owner_name":"MCP Hub","source_url":"https://tokrepo.com/en/workflows/mcp-agent-build-ai-agents-mcp-patterns-47de10df","content_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","visibility":1,"created_at":"2026-03-31 18:15:02","updated_at":"2026-06-17 18:44:54"},"target_adapter":{"target":"codex","adapter":"skill-directory","root":"~/.codex/skills","entrypoint":"SKILL.md","manifest_path":"~/.codex/tokrepo/install-manifest.json","staging_root":"~/.codex/tokrepo/staged/47de10df-654b-43b4-8869-8629119e532d","install_modes":["single","bundle","split","stage_only"],"activates_files":true},"install_plan":{"schema_version":2,"target":"codex","asset_uuid":"47de10df-654b-43b4-8869-8629119e532d","asset_title":"mcp-agent — Build AI Agents with MCP Patterns","source_url":"https://tokrepo.com/en/workflows/mcp-agent-build-ai-agents-mcp-patterns-47de10df","install_mode":"stage_only","entrypoint":"mcp-agent — Build AI Agents with MCP Patterns","preconditions":[{"type":"target_supported","status":"pass","message":"codex install target is supported"},{"type":"install_root","status":"pass","message":"~/.codex/skills for activated assets; ~/.codex/tokrepo/staged/47de10df-654b-43b4-8869-8629119e532d for staged assets"},{"type":"target_tool_metadata","status":"pass","message":"metadata allows codex"},{"type":"content_hash","status":"pass","message":"asset metadata includes content_hash"},{"type":"trust_policy","status":"pass","message":"publisher trust level is established"},{"type":"policy_decision","status":"warn","message":"stage_only for 47de10df-654b-43b4-8869-8629119e532d (stage_only)"}],"actions":[{"type":"stage_file","path":"~/.codex/tokrepo/staged/47de10df-654b-43b4-8869-8629119e532d/mcp-agent — Build AI Agents with MCP Patterns.md","source_name":"mcp-agent — Build AI Agents with MCP Patterns","sha256":"b7ade2656efd83840ef0e95fbae4c6a6730ce16056b8b18060031b1db42c2d94","bytes":3028,"risk":{"executes_code":false,"modifies_global_config":false,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"if_exists":"overwrite"}],"policy_decision":{"decision":"stage_only","requires_confirmation":false,"reasons":["asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true"]},"requires_confirmation":false,"rollback":[{"type":"remove_file","path":"~/.codex/tokrepo/staged/47de10df-654b-43b4-8869-8629119e532d/mcp-agent — Build AI Agents with MCP Patterns.md"}],"post_verify":[{"type":"file_sha256","path":"~/.codex/tokrepo/staged/47de10df-654b-43b4-8869-8629119e532d/mcp-agent — Build AI Agents with MCP Patterns.md","sha256":"b7ade2656efd83840ef0e95fbae4c6a6730ce16056b8b18060031b1db42c2d94"},{"type":"expected_file","path":"mcp-agent — Build AI Agents with MCP Patterns.md"}],"metadata":{"asset_kind":"mcp_config","target_tools":["claude_code","codex","cursor","gemini_cli","windsurf"],"install_mode":"stage_only","entrypoint":"mcp-agent — Build AI Agents with MCP Patterns","risk_profile":{"executes_code":false,"modifies_global_config":true,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"dependencies":{"npm":[],"pip":[],"brew":[],"system":[]},"content_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","verification":{"commands":[],"expected_files":["mcp-agent — Build AI Agents with MCP Patterns"]}},"agent_fit":{"target":"codex","score":17,"status":"stage_only","policy":"stage_only","why":["target_tools includes codex","asset_kind mcp_config","install_mode stage_only","policy stage_only","asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","trust established"],"asset_kind":"mcp_config","install_mode":"stage_only"},"trust":{"author_trust_level":"established","verified_publisher":false,"asset_signed_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","signature_status":"hash_only","install_count":0,"report_count":0,"dangerous_capability_badges":["mcp_config","modifies_global_config","stage_only"],"review_status":"unreviewed","signals":["asset has usage views","author has published assets","content hash available"]},"provenance":{"owner_uuid":"8a910281-3180-11f1-9bc6-00163e2b0d79","owner_name":"MCP Hub","source_url":"https://tokrepo.com/en/workflows/mcp-agent-build-ai-agents-mcp-patterns-47de10df","content_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","visibility":1,"created_at":"2026-03-31 18:15:02","updated_at":"2026-06-17 18:44:54"},"target_adapter":{"target":"codex","adapter":"skill-directory","root":"~/.codex/skills","entrypoint":"SKILL.md","manifest_path":"~/.codex/tokrepo/install-manifest.json","staging_root":"~/.codex/tokrepo/staged/47de10df-654b-43b4-8869-8629119e532d","install_modes":["single","bundle","split","stage_only"],"activates_files":true},"evidence_bundle":{"acceptance_gate":{"recommended_action":"stage_or_request_confirmation","rule":"Agents should only activate an asset after evidence_bundle.integrity, policy_compatibility, rollback, and post_verify have been inspected.","status":"caution"},"asset_title":"mcp-agent — Build AI Agents with MCP Patterns","asset_uuid":"47de10df-654b-43b4-8869-8629119e532d","eval_evidence":["https://tokrepo.com/evals/install-safety.json","https://tokrepo.com/evals/trust-evidence-coverage.json","https://tokrepo.com/evals/handoff-quality.json"],"generated_at":"2026-06-17T10:44:56Z","integrity":{"content_hash":"b6b23832baaa26113569d8154ca4c1f0cd2a989acd0b496bdd3ac42b2f6d9066","declared_content_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","file_count":1,"hash_algorithm":"sha256","install_plan_hash":"81b8fa7a39e3d8f8364cd0a92e6ea8a727a744ab888091f5e120c83452114143"},"policy_compatibility":{"permission_envelope":{"destructive":false,"executes_code":false,"file_count":1,"filesystem_write":["~/.codex/tokrepo/staged"],"global_config_write":true,"network":false,"requires_secrets":[],"uses_absolute_paths":false},"policy_decision":{"decision":"stage_only","requires_confirmation":false,"reasons":["asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true"]},"requires_confirmation":false,"target":"codex","trust_score_v2":{"recommended_action":"stage_or_request_confirmation","status":"caution","trust_score":60}},"provenance":{"asset_kind":"mcp_config","asset_title":"mcp-agent — Build AI Agents with MCP Patterns","asset_uuid":"47de10df-654b-43b4-8869-8629119e532d","computed_bundle_hash":"b6b23832baaa26113569d8154ca4c1f0cd2a989acd0b496bdd3ac42b2f6d9066","content_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","created_at":"2026-03-31 18:15:02","generated_at":"2026-06-17T10:44:56Z","install_plan_hash":"81b8fa7a39e3d8f8364cd0a92e6ea8a727a744ab888091f5e120c83452114143","owner_name":"MCP Hub","owner_uuid":"8a910281-3180-11f1-9bc6-00163e2b0d79","parent_uuid":"","schema_version":2,"source":"tokrepo_asset","source_url":"https://tokrepo.com/en/workflows/mcp-agent-build-ai-agents-mcp-patterns-47de10df","updated_at":"2026-06-17 18:44:54","visibility":1},"sbom":{"asset_kind":"mcp_config","asset_title":"mcp-agent — Build AI Agents with MCP Patterns","asset_uuid":"47de10df-654b-43b4-8869-8629119e532d","capability_flags":{"destructive":false,"executes_code":false,"modifies_global_config":true,"network_access":false,"requires_secrets":[]},"content_hash":"b6b23832baaa26113569d8154ca4c1f0cd2a989acd0b496bdd3ac42b2f6d9066","dependencies":{"brew":[],"mcp":[],"npm":[],"pip":[],"system":[]},"files":[{"bytes":3028,"path":"~/.codex/tokrepo/staged/47de10df-654b-43b4-8869-8629119e532d/mcp-agent — Build AI Agents with MCP Patterns.md","role":"supporting_file","sha256":"b7ade2656efd83840ef0e95fbae4c6a6730ce16056b8b18060031b1db42c2d94","source_name":"mcp-agent — Build AI Agents with MCP Patterns"}],"format":"SBOM-lite","install_mode":"stage_only","schema_version":1,"target":"codex"},"schema":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json","schema_version":1,"schemas":{"asset_verification":"https://tokrepo.com/schemas/asset-verification.schema.json","evidence_bundle":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json","install_plan":"https://tokrepo.com/schemas/install-plan.schema.json","provenance":"https://tokrepo.com/schemas/provenance.schema.json","sbom":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json#/properties/sbom"},"signature_evidence":{"content_hash":"b6b23832baaa26113569d8154ca4c1f0cd2a989acd0b496bdd3ac42b2f6d9066","hash_algorithm":"sha256","install_plan_hash":"81b8fa7a39e3d8f8364cd0a92e6ea8a727a744ab888091f5e120c83452114143","schema_version":1,"signed_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","status":"hash_only","verification_notes":["hash_only evidence proves content integrity but not publisher identity unless an external signature verifies it"]},"source_url":"https://tokrepo.com/en/workflows/mcp-agent-build-ai-agents-mcp-patterns-47de10df","target":"codex"},"sbom":{"asset_kind":"mcp_config","asset_title":"mcp-agent — Build AI Agents with MCP Patterns","asset_uuid":"47de10df-654b-43b4-8869-8629119e532d","capability_flags":{"destructive":false,"executes_code":false,"modifies_global_config":true,"network_access":false,"requires_secrets":[]},"content_hash":"b6b23832baaa26113569d8154ca4c1f0cd2a989acd0b496bdd3ac42b2f6d9066","dependencies":{"brew":[],"mcp":[],"npm":[],"pip":[],"system":[]},"files":[{"bytes":3028,"path":"~/.codex/tokrepo/staged/47de10df-654b-43b4-8869-8629119e532d/mcp-agent — Build AI Agents with MCP Patterns.md","role":"supporting_file","sha256":"b7ade2656efd83840ef0e95fbae4c6a6730ce16056b8b18060031b1db42c2d94","source_name":"mcp-agent — Build AI Agents with MCP Patterns"}],"format":"SBOM-lite","install_mode":"stage_only","schema_version":1,"target":"codex"},"signature_evidence":{"content_hash":"b6b23832baaa26113569d8154ca4c1f0cd2a989acd0b496bdd3ac42b2f6d9066","hash_algorithm":"sha256","install_plan_hash":"81b8fa7a39e3d8f8364cd0a92e6ea8a727a744ab888091f5e120c83452114143","schema_version":1,"signed_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","status":"hash_only","verification_notes":["hash_only evidence proves content integrity but not publisher identity unless an external signature verifies it"]},"provenance_v2":{"asset_kind":"mcp_config","asset_title":"mcp-agent — Build AI Agents with MCP Patterns","asset_uuid":"47de10df-654b-43b4-8869-8629119e532d","computed_bundle_hash":"b6b23832baaa26113569d8154ca4c1f0cd2a989acd0b496bdd3ac42b2f6d9066","content_hash":"53e921067606c22f8fcd7dcde695f457e0e612ee1324b1dfa2a96a57144833ab","created_at":"2026-03-31 18:15:02","generated_at":"2026-06-17T10:44:56Z","install_plan_hash":"81b8fa7a39e3d8f8364cd0a92e6ea8a727a744ab888091f5e120c83452114143","owner_name":"MCP Hub","owner_uuid":"8a910281-3180-11f1-9bc6-00163e2b0d79","parent_uuid":"","schema_version":2,"source":"tokrepo_asset","source_url":"https://tokrepo.com/en/workflows/mcp-agent-build-ai-agents-mcp-patterns-47de10df","updated_at":"2026-06-17 18:44:54","visibility":1},"transitive_dependencies":null}}