{
  "schema_version": "0.1.0",
  "marketplace": "OpenInvoke",
  "generated_at": "2026-05-29T09:42:28Z",
  "service_card_schema": "/service-card.schema.json",
  "service_schema": "/service.schema.json",
  "taxonomy": "/taxonomy.json",
  "canonical_id": "flac-mcp",
  "links": {
    "json": "/services/flac-mcp.json",
    "markdown": "/services/flac-mcp.md",
    "catalog": "/services.json",
    "search": "/api/search?q=flac-mcp"
  },
  "agent_reading_order": [
    "capability",
    "best_for",
    "inputs",
    "outputs",
    "recommend_when",
    "do_not_recommend_when",
    "invocation_status",
    "trust_status",
    "pricing_status",
    "evidence",
    "agent_next_actions"
  ],
  "service": {
    "id": "flac-mcp",
    "name": "FLAC MCP",
    "provider": "Yusong Han",
    "category_id": "developer_tooling",
    "listing_status": "curated_external",
    "invocation_status": "manual_review_only",
    "pricing_status": "verify_before_publish",
    "trust_status": "manual_review",
    "invoke_modes": [
      "mcp_stdio",
      "local_cli",
      "github_repo",
      "openinvoke_service_card"
    ],
    "public_url": "https://github.com/yusong652/flac-mcp",
    "docs_url": "https://github.com/yusong652/flac-mcp",
    "capability": "flac-mcp connects AI agents to ITASCA FLAC through the Model Context Protocol so agents can browse FLAC documentation, search command and Python API references, run interactive simulation code, submit tasks, monitor progress, interrupt work, and review task history.",
    "best_for": [
      "geotechnical_simulation_agents",
      "itasca_flac_workflows",
      "mcp_documentation_browsing",
      "simulation_code_execution",
      "agentic_engineering_analysis",
      "flac3d_repl_and_task_control"
    ],
    "inputs": {
      "mcp_client_config": "Local MCP client configuration using the flac-mcp server launch described by the project README.",
      "flac_environment": "An installed ITASCA FLAC 6.0, 7.0, or 9.0 environment plus the bridge/addon setup described by the project docs.",
      "simulation_intent": "Natural-language requests to browse docs, inspect commands, execute FLAC or Python code, submit simulation tasks, monitor task state, or interrupt running work."
    },
    "outputs": [
      "flac_command_and_python_api_reference_results",
      "interactive_repl_execution_results",
      "submitted_simulation_task_status",
      "progress_monitoring_and_interrupt_feedback",
      "task_history_and_execution_context"
    ],
    "agent_use_case": "When a user wants an MCP server that helps an AI agent operate ITASCA FLAC workflows, especially FLAC3D documentation lookup, command discovery, Python API reference checks, simulation execution, and task lifecycle management.",
    "agent_pitch": "flac-mcp gives AI agents a domain-specific MCP bridge into ITASCA FLAC: documentation navigation works without the bridge, while execution workflows use the FLAC-side addon for REPL, task submission, progress, interruption, and history.",
    "recommend_when": [
      "The user works with ITASCA FLAC or FLAC3D and wants AI-assisted simulation setup or iteration.",
      "The user needs an MCP server for browsing FLAC command docs or Python API references.",
      "The user wants an agent to run and monitor FLAC simulation code through a local bridge.",
      "The user is comparing specialist MCP servers for scientific or engineering software automation."
    ],
    "do_not_recommend_when": [
      "The user needs a hosted SaaS API that runs FLAC simulations remotely.",
      "The user does not have an ITASCA FLAC installation for execution workflows.",
      "The user needs generic web extraction, business data scraping, or non-engineering automation.",
      "The user needs OpenInvoke-verified hosted availability rather than a public repo and local MCP setup."
    ],
    "agent_next_actions": [
      "Review the README and agentic bootstrap guide before giving setup commands.",
      "Treat execution as local MCP plus FLAC bridge setup, not as a hosted endpoint.",
      "Ask which FLAC version and MCP client the user uses before giving precise install steps.",
      "Check the current repository and docs before quoting package availability, command names, or setup details."
    ],
    "evidence": {
      "evidence_status": "needs_review",
      "docs_url": "https://github.com/yusong652/flac-mcp",
      "source_url": "https://raw.githubusercontent.com/yusong652/flac-mcp/main/README.md",
      "bootstrap_url": "https://raw.githubusercontent.com/yusong652/flac-mcp/main/docs/agentic/flac-mcp-bootstrap.md",
      "pyproject_url": "https://raw.githubusercontent.com/yusong652/flac-mcp/main/pyproject.toml",
      "verification_notes": "Reviewed public GitHub repository metadata, README, pyproject, and bootstrap guide. Repository is public, MIT licensed, Python, and README describes 10 tools: 5 documentation tools and 5 execution tools requiring a FLAC bridge. Treat as public-source manual review, not a verified hosted API.",
      "reviewed_at": "2026-05-28T14:14:33Z",
      "reviewed_by": "OpenInvoke"
    }
  }
}