Paramus Chemistry

Auto-detect (bash / macOS / Linux)

if curl -sf -o /dev/null --connect-timeout 2 http://localhost:8765/health 2>/dev/null; then
  export PARAMUS_URL="http://localhost:8765/"
  export PARAMUS_AUTH=""
elif [ -n "$PARAMUS_API_TOKEN" ]; then
  export PARAMUS_URL="https://cloud1.paramus.ai/mcp"
  export PARAMUS_AUTH="Authorization: Bearer $PARAMUS_API_TOKEN"
else
  echo "ERROR: No local Paramus and no PARAMUS_API_TOKEN set"
fi

Auto-detect (PowerShell / Windows)

$local = try { (Invoke-WebRequest -Uri http://localhost:8765/health -TimeoutSec 2 -UseBasicParsing).StatusCode -eq 200 } catch { $false }
if ($local) {
  $env:PARAMUS_URL = "http://localhost:8765/"
  $env:PARAMUS_AUTH = ""
} elseif ($env:PARAMUS_API_TOKEN) {
  $env:PARAMUS_URL = "https://cloud1.paramus.ai/mcp"
  $env:PARAMUS_AUTH = "Authorization: Bearer $env:PARAMUS_API_TOKEN"
} else {
  Write-Host "ERROR: No local Paramus and no PARAMUS_API_TOKEN set"
}

If both fail, tell the user:

• Local: Download Paramus from https://cloud1.paramus.ai and start the tray app (runs on localhost:8765)
• Cloud: Sign in at https://cloud1.paramus.ai, copy the API Key from the credentials card, then set the env var:
  • bash: export PARAMUS_API_TOKEN="paramus_live_..."
  • PowerShell: $env:PARAMUS_API_TOKEN = "paramus_live_..."

Privacy note

• Local mode (localhost:8765): All data stays on the user's device. Recommended for proprietary molecules or sensitive formulations.
• Cloud mode (cloud1.paramus.ai): Chemical data is sent to Paramus servers for processing. Use only if user consents to external API calls.

Always prefer local mode when available. If handling sensitive data and local is unavailable, inform the user before making cloud calls.

How to call tools

On Windows use curl.exe instead of curl. On macOS/Linux use curl.

Search for a tool by description:

curl -sf -X POST "$PARAMUS_URL" \
  -H "Content-Type: application/json" \
  ${PARAMUS_AUTH:+-H "$PARAMUS_AUTH"} \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"molecular weight from SMILES"}}}'

PowerShell equivalent:

$headers = @{"Content-Type"="application/json"}
if ($env:PARAMUS_AUTH) { $headers["Authorization"] = ($env:PARAMUS_AUTH -replace "^Authorization: Bearer ","Bearer ") }
$body = '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"molecular weight from SMILES"}}}'
Invoke-RestMethod -Uri $env:PARAMUS_URL -Method POST -Headers $headers -Body $body

Direct call a tool by exact name:

curl -sf -X POST "$PARAMUS_URL" \
  -H "Content-Type: application/json" \
  ${PARAMUS_AUTH:+-H "$PARAMUS_AUTH"} \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"direct_call","arguments":{"toolName":"calculate_molecular_weight","toolArguments":{"smiles":"CCO"}}}}'

PowerShell equivalent:

$body = '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"direct_call","arguments":{"toolName":"calculate_molecular_weight","toolArguments":{"smiles":"CCO"}}}}'
Invoke-RestMethod -Uri $env:PARAMUS_URL -Method POST -Headers $headers -Body $body

Get schema to check parameters:

curl -sf -X POST "$PARAMUS_URL" \
  -H "Content-Type: application/json" \
  ${PARAMUS_AUTH:+-H "$PARAMUS_AUTH"} \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_schema","arguments":{"toolName":"calculate_logp"}}}'

List categories:

curl -sf -X POST "$PARAMUS_URL" \
  -H "Content-Type: application/json" \
  ${PARAMUS_AUTH:+-H "$PARAMUS_AUTH"} \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_categories","arguments":{}}}' 

List tools in a category:

curl -sf -X POST "$PARAMUS_URL" \
  -H "Content-Type: application/json" \
  ${PARAMUS_AUTH:+-H "$PARAMUS_AUTH"} \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_by_category","arguments":{"category":"Chemistry"}}}'

Workflow for every chemistry question

1. Run auto-detect (if not done yet in this session)
2. Search for relevant tools matching the user's question
3. Get schema for the tool to see required parameters
4. Direct call the tool with proper parameters
5. Parse JSON response and present the result with units

Tool categories (319 tools total)

Notes

• First call may take ~1s (library loading). Subsequent calls are <10ms.
• SMILES strings are the primary molecular input. If user gives a name, ask for SMILES or look it up first.
• All numeric results include units.
• Gateway tool names use snake_case: search, direct_call, get_schema, list_categories, list_by_category.
• Parameter names inside arguments are camelCase: toolName, toolArguments.