Packages
This project is organized as a set of focused Julia packages. The table below summarizes responsibilities and typical usage.
| Package | Purpose | Typical Use |
|---|---|---|
JCGECore | RunSpec, sections, sets/mappings, scenarios, validation, and closure-condition roles | Define model structure and closure choices |
JCGEBlocks | Reusable CGE blocks, auxiliary-quantity equations, and stable equation-condition keys | Assemble production/household/market systems, make supplementary quantities endogenous, and declare accounting checks |
JCGERuntime | Role-aware compilation, solver execution, residual diagnostics, and experiment workflows | Solve a RunSpec and run parameter/policy batches |
JCGECalibrate | SAM loading and calibration | Derive parameters and starting values |
JCGEOutput | Equation rendering, results containers, accounting-check reporting, and satellite quantities | Export equations, tidy results, physical-flow projections, balance checks, and DualSignals |
JCGEExamples | Reference models and scenarios | Canonical model ports, documented input contracts, and solver-backed scenario examples |
JCGEImportData | Source adapters, IO/SUT transformations, balance diagnostics, and canonical-data writing | Prepare declared source accounts for model-owned SAM construction |
JCGEImportMPSGE | MPSGE.jl importer | Translate MPSGE objects to RunSpecs |
JCGEAgentInterface | MCP-compatible framework interface | AI-assisted catalogue discovery, source-data and modelling guidance, and controlled model workflows through a separate MCP host |
Each package has its own documentation site and API reference. This repository keeps the ecosystem narrative consistent, but package-specific details belong in those package docs.
Reference-model coverage
JCGEExamples includes models ranging from small teaching examples to literature-based CGE formulations. Its GTAP7 example is an independent, data-driven implementation of the core GTAP Standard 7 multi-region structure. It demonstrates CDE private demand, bilateral Armington sourcing and CET sales allocation, regional external accounts, and global saving–investment closure using a small open synthetic fixture. It also provides declared shocks to factor endowments, productivity, taxes, demand preferences, private saving, and route delivery costs. The full model and its input contract are documented in JCGEExamples. GTAP7MCP is its PATH/MCP companion: it uses the same compact fixture and declared counterfactuals while pairing the equilibrium conditions explicitly with their model variables.
Resources
For agent-based use, see the AI Agent Interface guide. The released MCP server is registered as io.github.equicirco/JCGEAgentInterface.jl and the container image is published as ghcr.io/equicirco/jcge-agentinterface-mcp:<release-version>.
For solver conditions, retained accounting identities, and their reporting, see Closures & Checks.