leo-claude-mktplace/plugins/contract-validator/skills/mcp-tools-reference.md

Skill: MCP Tools Reference

Available MCP tools for contract-validator operations.

Tool Categories

Parse Tools

Tool	Description
parse_plugin_interface	Extract interface from plugin README.md
parse_claude_md_agents	Extract agents and tool sequences from CLAUDE.md

Validation Tools

Tool	Description
validate_compatibility	Check two plugins for conflicts
validate_agent_refs	Check agent tool references exist
validate_data_flow	Verify data flow through agent sequence
validate_workflow_integration	Check domain plugin exposes required advisory interfaces and gate contract version

Report Tools

Tool	Description
generate_compatibility_report	Generate full marketplace report (JSON)
list_issues	Filter issues by severity or type

Tool Usage Patterns

Full Marketplace Validation

1. generate_compatibility_report(marketplace_path)
2. list_issues(severity="ERROR")  # Get critical issues
3. list_issues(severity="WARNING")  # Get warnings

Single Agent Check

1. parse_claude_md_agents(claude_md_path)
2. validate_agent_refs(agent_name, agents_data)
3. validate_data_flow(agent_workflow)

Interface Listing

1. For each plugin:
   parse_plugin_interface(readme_path)
2. Aggregate results into summary table

Dependency Graph

1. generate_compatibility_report(marketplace_path)
2. validate_data_flow(cross_plugin_flows)
3. Build Mermaid diagram from results

Workflow Integration Check

1. validate_workflow_integration(plugin_path, domain_label)  # Check single domain plugin
2. validate_workflow_integration(plugin_path, domain_label, expected_contract="v1")  # With contract version check
3. For each domain in domain-consultation.md detection rules:
     validate_workflow_integration(domain_plugin_path, domain_label, expected_contract)

Error Handling

If MCP tools fail:

1. Check if /cv-setup has been run
2. Verify session was restarted after setup
3. Check MCP server venv exists and is valid