{"schema_version":1,"workflow_uuid":"8cf17e75-0c30-4c57-971d-34d7284e4049","workflow_title":"Build Your Own MCP Server — Step-by-Step Guide","page_url":"https://tokrepo.com/en/workflows/build-your-own-mcp-server-step-step-guide-8cf17e75","raw_url":"https://tokrepo.com/raw/build-your-own-mcp-server-step-step-guide-8cf17e75","metadata_url":"https://tokrepo.com/metadata/build-your-own-mcp-server-step-step-guide-8cf17e75.json","install_plan_url":"https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid=8cf17e75-0c30-4c57-971d-34d7284e4049&target=codex","recommended_install":{"schema_version":1,"status":"stage","policy":"stage_only","install_mode":"stage_only","target":"codex","command":"npx -y tokrepo@latest install 8cf17e75-0c30-4c57-971d-34d7284e4049 --target codex","dry_run_command":"npx -y tokrepo@latest install 8cf17e75-0c30-4c57-971d-34d7284e4049 --target codex --dry-run --json","runtime_commands":{"codex":"npx -y tokrepo@latest install 8cf17e75-0c30-4c57-971d-34d7284e4049 --target codex","gemini":"npx -y tokrepo@latest install 8cf17e75-0c30-4c57-971d-34d7284e4049 --target gemini","project":"npx -y tokrepo@latest install 8cf17e75-0c30-4c57-971d-34d7284e4049"},"prompt":"Install and make this TokRepo asset usable: \"Build Your Own MCP Server — Step-by-Step Guide\".\n\nPage: https://tokrepo.com/en/workflows/build-your-own-mcp-server-step-step-guide-8cf17e75\nUUID: 8cf17e75-0c30-4c57-971d-34d7284e4049\nTarget adapter: codex\nPolicy/mode: stage_only / stage_only\n\nRead these machine-facing entry points first:\n- metadata: https://tokrepo.com/metadata/build-your-own-mcp-server-step-step-guide-8cf17e75.json\n- install contract: https://tokrepo.com/install-contract/build-your-own-mcp-server-step-step-guide-8cf17e75.json\n- install plan: https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid=8cf17e75-0c30-4c57-971d-34d7284e4049&target=codex\n- raw content: https://tokrepo.com/raw/build-your-own-mcp-server-step-step-guide-8cf17e75\n\nCommands:\n- choose the current runtime; do not use unsupported CLI targets.\n- Codex: npx -y tokrepo@latest install 8cf17e75-0c30-4c57-971d-34d7284e4049 --target codex\n- Gemini CLI: npx -y tokrepo@latest install 8cf17e75-0c30-4c57-971d-34d7284e4049 --target gemini\n- Claude Code / project agent: run npx -y tokrepo@latest install 8cf17e75-0c30-4c57-971d-34d7284e4049 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","cursor"],"install_mode":"stage_only","entrypoint":"Build Your Own MCP Server — Step-by-Step Guide","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":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","verification":{"commands":[],"expected_files":["Build Your Own MCP Server — Step-by-Step Guide"]}},"agent_fit":{"target":"codex","score":17,"status":"stage_only","policy":"stage_only","why":["target_tools does not include codex","asset_kind mcp_config","install_mode stage_only","policy stage_only","metadata target_tools does not include codex","asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","trust community"],"asset_kind":"mcp_config","install_mode":"stage_only"},"trust":{"author_trust_level":"community","verified_publisher":false,"asset_signed_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","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":"8a9109f5-3180-11f1-9bc6-00163e2b0d79","owner_name":"Prompt Lab","source_url":"https://tokrepo.com/en/workflows/build-your-own-mcp-server-step-step-guide-8cf17e75","content_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","visibility":1,"created_at":"2026-04-07 06:16:09","updated_at":"2026-07-07 09:57:51"},"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/8cf17e75-0c30-4c57-971d-34d7284e4049","install_modes":["single","bundle","split","stage_only"],"activates_files":true},"install_plan":{"schema_version":2,"target":"codex","asset_uuid":"8cf17e75-0c30-4c57-971d-34d7284e4049","asset_title":"Build Your Own MCP Server — Step-by-Step Guide","source_url":"https://tokrepo.com/en/workflows/build-your-own-mcp-server-step-step-guide-8cf17e75","install_mode":"stage_only","entrypoint":"Build Your Own MCP Server — Step-by-Step Guide","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/8cf17e75-0c30-4c57-971d-34d7284e4049 for staged assets"},{"type":"target_tool_metadata","status":"warn","message":"metadata target_tools does not include codex"},{"type":"content_hash","status":"pass","message":"asset metadata includes content_hash"},{"type":"trust_policy","status":"warn","message":"low trust publisher plus dangerous capability requires staging"},{"type":"policy_decision","status":"warn","message":"stage_only for 8cf17e75-0c30-4c57-971d-34d7284e4049 (stage_only)"}],"actions":[{"type":"stage_file","path":"~/.codex/tokrepo/staged/8cf17e75-0c30-4c57-971d-34d7284e4049/Build Your Own MCP Server — Step-by-Step Guide.md","source_name":"Build Your Own MCP Server — Step-by-Step Guide","sha256":"3b0c8536f585611597f5957e750ee9a11f84e639499ca40b74cd29eec1da5750","bytes":5475,"risk":{"executes_code":false,"modifies_global_config":true,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"if_exists":"overwrite"}],"policy_decision":{"decision":"stage_only","requires_confirmation":false,"reasons":["metadata target_tools does not include codex","asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","low trust publisher plus dangerous capability requires staging"]},"requires_confirmation":false,"rollback":[{"type":"remove_file","path":"~/.codex/tokrepo/staged/8cf17e75-0c30-4c57-971d-34d7284e4049/Build Your Own MCP Server — Step-by-Step Guide.md"}],"post_verify":[{"type":"file_sha256","path":"~/.codex/tokrepo/staged/8cf17e75-0c30-4c57-971d-34d7284e4049/Build Your Own MCP Server — Step-by-Step Guide.md","sha256":"3b0c8536f585611597f5957e750ee9a11f84e639499ca40b74cd29eec1da5750"},{"type":"expected_file","path":"Build Your Own MCP Server — Step-by-Step Guide.md"}],"metadata":{"asset_kind":"mcp_config","target_tools":["claude_code","cursor"],"install_mode":"stage_only","entrypoint":"Build Your Own MCP Server — Step-by-Step Guide","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":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","verification":{"commands":[],"expected_files":["Build Your Own MCP Server — Step-by-Step Guide"]}},"agent_fit":{"target":"codex","score":17,"status":"stage_only","policy":"stage_only","why":["target_tools does not include codex","asset_kind mcp_config","install_mode stage_only","policy stage_only","metadata target_tools does not include codex","asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","trust community"],"asset_kind":"mcp_config","install_mode":"stage_only"},"trust":{"author_trust_level":"community","verified_publisher":false,"asset_signed_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","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":"8a9109f5-3180-11f1-9bc6-00163e2b0d79","owner_name":"Prompt Lab","source_url":"https://tokrepo.com/en/workflows/build-your-own-mcp-server-step-step-guide-8cf17e75","content_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","visibility":1,"created_at":"2026-04-07 06:16:09","updated_at":"2026-07-07 09:57:51"},"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/8cf17e75-0c30-4c57-971d-34d7284e4049","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":"Build Your Own MCP Server — Step-by-Step Guide","asset_uuid":"8cf17e75-0c30-4c57-971d-34d7284e4049","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-07-07T01:57:53Z","integrity":{"content_hash":"65ee46b9d44de9f7c5123834acce6723343dc8d9f2860d15712ae5db1e8d8a05","declared_content_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","file_count":1,"hash_algorithm":"sha256","install_plan_hash":"5b20895302e66b8b0829e08d4bb0187aff42a4c2f8e7ddc5152ec0117e5c18f2"},"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":["metadata target_tools does not include codex","asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","low trust publisher plus dangerous capability requires staging"]},"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":"Build Your Own MCP Server — Step-by-Step Guide","asset_uuid":"8cf17e75-0c30-4c57-971d-34d7284e4049","computed_bundle_hash":"65ee46b9d44de9f7c5123834acce6723343dc8d9f2860d15712ae5db1e8d8a05","content_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","created_at":"2026-04-07 06:16:09","generated_at":"2026-07-07T01:57:53Z","install_plan_hash":"5b20895302e66b8b0829e08d4bb0187aff42a4c2f8e7ddc5152ec0117e5c18f2","owner_name":"Prompt Lab","owner_uuid":"8a9109f5-3180-11f1-9bc6-00163e2b0d79","parent_uuid":"","schema_version":2,"source":"tokrepo_asset","source_url":"https://tokrepo.com/en/workflows/build-your-own-mcp-server-step-step-guide-8cf17e75","updated_at":"2026-07-07 09:57:51","visibility":1},"sbom":{"asset_kind":"mcp_config","asset_title":"Build Your Own MCP Server — Step-by-Step Guide","asset_uuid":"8cf17e75-0c30-4c57-971d-34d7284e4049","capability_flags":{"destructive":false,"executes_code":false,"modifies_global_config":true,"network_access":false,"requires_secrets":[]},"content_hash":"65ee46b9d44de9f7c5123834acce6723343dc8d9f2860d15712ae5db1e8d8a05","dependencies":{"brew":[],"mcp":[],"npm":[],"pip":[],"system":[]},"files":[{"bytes":5475,"path":"~/.codex/tokrepo/staged/8cf17e75-0c30-4c57-971d-34d7284e4049/Build Your Own MCP Server — Step-by-Step Guide.md","role":"supporting_file","sha256":"3b0c8536f585611597f5957e750ee9a11f84e639499ca40b74cd29eec1da5750","source_name":"Build Your Own MCP Server — Step-by-Step Guide"}],"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":"65ee46b9d44de9f7c5123834acce6723343dc8d9f2860d15712ae5db1e8d8a05","hash_algorithm":"sha256","install_plan_hash":"5b20895302e66b8b0829e08d4bb0187aff42a4c2f8e7ddc5152ec0117e5c18f2","schema_version":1,"signed_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","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/build-your-own-mcp-server-step-step-guide-8cf17e75","target":"codex"},"sbom":{"asset_kind":"mcp_config","asset_title":"Build Your Own MCP Server — Step-by-Step Guide","asset_uuid":"8cf17e75-0c30-4c57-971d-34d7284e4049","capability_flags":{"destructive":false,"executes_code":false,"modifies_global_config":true,"network_access":false,"requires_secrets":[]},"content_hash":"65ee46b9d44de9f7c5123834acce6723343dc8d9f2860d15712ae5db1e8d8a05","dependencies":{"brew":[],"mcp":[],"npm":[],"pip":[],"system":[]},"files":[{"bytes":5475,"path":"~/.codex/tokrepo/staged/8cf17e75-0c30-4c57-971d-34d7284e4049/Build Your Own MCP Server — Step-by-Step Guide.md","role":"supporting_file","sha256":"3b0c8536f585611597f5957e750ee9a11f84e639499ca40b74cd29eec1da5750","source_name":"Build Your Own MCP Server — Step-by-Step Guide"}],"format":"SBOM-lite","install_mode":"stage_only","schema_version":1,"target":"codex"},"signature_evidence":{"content_hash":"65ee46b9d44de9f7c5123834acce6723343dc8d9f2860d15712ae5db1e8d8a05","hash_algorithm":"sha256","install_plan_hash":"5b20895302e66b8b0829e08d4bb0187aff42a4c2f8e7ddc5152ec0117e5c18f2","schema_version":1,"signed_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","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":"Build Your Own MCP Server — Step-by-Step Guide","asset_uuid":"8cf17e75-0c30-4c57-971d-34d7284e4049","computed_bundle_hash":"65ee46b9d44de9f7c5123834acce6723343dc8d9f2860d15712ae5db1e8d8a05","content_hash":"6a08af5cc16a6ced68d375e4658b8e3bb8c0cd694f27da0e84d922affc33f80d","created_at":"2026-04-07 06:16:09","generated_at":"2026-07-07T01:57:53Z","install_plan_hash":"5b20895302e66b8b0829e08d4bb0187aff42a4c2f8e7ddc5152ec0117e5c18f2","owner_name":"Prompt Lab","owner_uuid":"8a9109f5-3180-11f1-9bc6-00163e2b0d79","parent_uuid":"","schema_version":2,"source":"tokrepo_asset","source_url":"https://tokrepo.com/en/workflows/build-your-own-mcp-server-step-step-guide-8cf17e75","updated_at":"2026-07-07 09:57:51","visibility":1},"transitive_dependencies":null}}