Hello-QM/catgo-LRG / server/catgo/workflow/skills/orca/opt
orca-opt
VerifiedORCA geometry optimization. Handles method/basis selection, dispersion corrections, solvent models, and convergence settings.
ORCA Geometry Optimization Skill
When to Use
Use this skill when the user wants to:
- Optimize a molecular geometry with ORCA
- Find the minimum energy structure of a molecule
- Relax a molecular cluster or complex
Do NOT use for periodic systems (use VASP or CP2K instead).
Default Parameters
| Parameter | Default | Description |
|---|---|---|
orca_method | B3LYP | DFT functional |
orca_basis | def2-SVP | Basis set |
charge | 0 | Total charge |
multiplicity | 1 | Spin multiplicity (2S+1) |
orca_extra_keywords | "" | Additional ORCA keywords |
MCP Tool Examples
Basic optimization
First, confirm the structure is loaded:
catgo_view(action: "get_state")
Create workflow and add optimization task:
catgo_workflow_engine(action: "create", params: {
name: "Benzene optimization"
})
catgo_workflow_engine(action: "add_task", params: {
workflow_id: "<wf_id>",
task_type: "geo_opt",
params: {
software: "orca",
orca_method: "B3LYP",
orca_basis: "def2-SVP",
charge: 0,
multiplicity: 1
}
})
With dispersion correction (D3BJ)
For systems with non-covalent interactions (dimers, host-guest, protein-ligand):
catgo_workflow_engine(action: "add_task", params: {
workflow_id: "<wf_id>",
task_type: "geo_opt",
params: {
software: "orca",
orca_method: "B3LYP",
orca_basis: "def2-TZVP",
orca_extra_keywords: "D3BJ",
charge: 0,
multiplicity: 1
}
})
With solvent (CPCM)
For solution-phase chemistry:
catgo_workflow_engine(action: "add_task", params: {
workflow_id: "<wf_id>",
task_type: "geo_opt",
params: {
software: "orca",
orca_method: "B3LYP",
orca_basis: "def2-SVP",
orca_extra_keywords: "CPCM(Water)",
charge: 0,
multiplicity: 1
}
})
Tight optimization convergence
For publication-quality geometries or pre-frequency calculations:
catgo_workflow_engine(action: "add_task", params: {
workflow_id: "<wf_id>",
task_type: "geo_opt",
params: {
software: "orca",
orca_method: "B3LYP",
orca_basis: "def2-TZVP",
orca_extra_keywords: "TightOpt D3BJ",
charge: 0,
multiplicity: 1
}
})
Open-shell system (radical)
For a doublet radical like NO2:
catgo_workflow_engine(action: "add_task", params: {
workflow_id: "<wf_id>",
task_type: "geo_opt",
params: {
software: "orca",
orca_method: "UB3LYP",
orca_basis: "def2-SVP",
charge: 0,
multiplicity: 2
}
})
Submit the workflow
catgo_workflow_engine(action: "submit", params: {
workflow_id: "<wf_id>"
})
Check status
catgo_workflow_engine(action: "status", params: {
workflow_id: "<wf_id>"
})
Get results
catgo_workflow_engine(action: "get_result", params: {
workflow_id: "<wf_id>",
task_id: "<task_id>"
})
Dispersion Corrections
| Keyword | Method | When to use |
|---|---|---|
D3BJ | Grimme D3 with Becke-Johnson damping | Default choice for dispersion |
D3 | Grimme D3 with zero damping | Legacy, use D3BJ instead |
D4 | Grimme D4 | Newer, slightly better for metals |
Always include dispersion for: molecular dimers, adsorption complexes, conformational searches, anything with pi-stacking or H-bonding.
Basis Set Ladder
| Basis | Quality | Cost | Use |
|---|---|---|---|
| def2-SVP | Double-zeta | Low | Screening, initial opt |
| def2-TZVP | Triple-zeta | Medium | Production geometry |
| def2-TZVPP | Triple-zeta+pol | High | Accurate energetics |
| def2-QZVPP | Quadruple-zeta | Very high | Benchmark only |
Strategy: optimize with def2-SVP, then single-point with def2-TZVP for energy.
SCF Convergence Issues
If ORCA SCF does not converge, try adding to orca_extra_keywords:
SlowConv-- dampened SCF for difficult casesVerySlowConv-- even more conservativeSOSCF-- second-order SCF (helps for transition metals)SmearTemp 5000-- Fermi smearing for near-degenerate orbitals
Common Mistakes
- Forgetting dispersion for non-covalent systems (huge geometry errors)
- Using restricted (R) method for open-shell (use UB3LYP, not B3LYP)
- Basis set too large for optimization (optimize with SVP, refine energy with TZVP)
- Not checking for imaginary frequencies after optimization
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |