Learn how to interact with mCGCNN using the Ouro SDK or REST API.
API access requires an API key. Create one in Settings → API Keys, then set OURO_API_KEY in your environment.
Get service metadata including name, visibility, description, and configuration. You can retrieve by service ID or identifier.
Retrieve the OpenAPI specification for this service to understand available endpoints and their parameters.
Get all routes for this service and use them programmatically.
Click on an endpoint to view its detailed documentation.
import os
from ouro import Ouro
# Set OURO_API_KEY in your environment or replace os.environ.get("OURO_API_KEY")
ouro = Ouro(api_key=os.environ.get("OURO_API_KEY"))
# Option 1: Retrieve by service ID
service_id = "c02573a9-f93f-4d26-bf5b-96d26d96326f"
service = ouro.services.retrieve(service_id)
# Option 2: Retrieve by service identifier (username/service-name)
service_identifier = "mmoderwell/mcgcnn"
service = ouro.services.retrieve(service_identifier)
print(service.name, service.visibility)
print(service.metadata)# Retrieve the service
service = ouro.services.retrieve("mmoderwell/mcgcnn")
# Read the OpenAPI spec
spec = ouro.services.read_spec(service.id)
print(spec.get("openapi"))
print(spec.get("info"))# Retrieve the service
service = ouro.services.retrieve("mmoderwell/mcgcnn")
# Get all routes for this service
routes = ouro.services.read_routes(service.id)
for route in routes:
print(f"{route.route.method} {route.route.path}")
print(f" Summary: {route.route.summary}")mCGCNN is a dual-stream crystal graph convolutional neural network for magnetic property prediction. It augments the full crystal graph with a magnetic subgraph that encodes metal–ligand–metal exchange geometry (Goodenough–Kanamori–Anderson rules), then predicts the DFT total magnetic moment per unit cell in μB. Saturation magnetization (Ms / μ₀ Ms) is derived from that moment and the CIF cell volume.
Best for ligand-bridged magnets (oxides, nitrides, and other M–X–M systems). Not recommended for elemental metals or alloys without bridging ligands — those are out of distribution for this checkpoint.
Input structures must contain at least one magnetic site (transition metal, lanthanoid, or actinoid).
Paper: https://arxiv.org/abs/2606.28458 Code: https://github.com/SouravMal/mCGCNN
Is supplement to
Sourav Mal & Satadeep Bhattacharjee · 2026