For the complete documentation index, see llms.txt.

Potential Energy Calculator API

science 1 credits / call v2026-04-22

Calculate gravitational or elastic potential energy and solve for missing variables.

Use this endpoint when your app or AI agent needs exact JSON instead of spending LLM tokens on well-defined utility work.

Prefer the browser version? Open the Potential Energy Calculator on miniwebtool.com.

Start free — get a key → 1,000 credits · no card · 30 seconds

Endpoint

POST https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run

Request body

Field Type Req.
energy_type
gravitational | elastic
str
solve_for
energy | mass | height | spring_constant | displacement
str
energy float | None
mass float | None
height float | None
spring_constant float | None
displacement float | None
planet
earth | moon | mars | jupiter | venus | saturn | mercury | custom
str
custom_g float | None
energy_unit
J | kJ | MJ | cal | kcal | Wh | kWh | eV | BTU | ftlb
str
mass_unit
kg | g | mg | lb | oz | ton
str
height_unit
m | cm | km | ft | in | mi
str
spring_unit
Nm | kNm | lbin | lbft
str
displacement_unit
m | cm | mm | in | ft
str

Cost & access

  • 1 credit per successful call.
  • Starts on: Free.
  • Max payload: 65536 bytes.
  • Privacy mode: hash_only
  • Available on: free, starter, pro, business, scale

Response envelope

{
  "request_id": "01K...",
  "tool": "potential-energy-calculator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": { ... }
}

Try it

Stored only in this browser tab. Playground test key is prefilled and only works on this page. Get a live key →
gravitational | elastic
energy | mass | height | spring_constant | displacement
earth | moon | mars | jupiter | venus | saturn | mercury | custom
J | kJ | MJ | cal | kcal | Wh | kWh | eV | BTU | ftlb
kg | g | mg | lb | oz | ton
m | cm | km | ft | in | mi
Nm | kNm | lbin | lbft
m | cm | mm | in | ft

Code examples

curl -X POST https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"energy_type":"gravitational","solve_for":"energy","mass":2,"height":3,"planet":"earth","energy_unit":"J","mass_unit":"kg","height_unit":"m","spring_unit":"Nm","displacement_unit":"m"}'
import requests

resp = requests.post(
    'https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run',
    headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'},
    json={'energy_type': 'gravitational', 'solve_for': 'energy', 'mass': 2, 'height': 3, 'planet': 'earth', 'energy_unit': 'J', 'mass_unit': 'kg', 'height_unit': 'm', 'spring_unit': 'Nm', 'displacement_unit': 'm'},
)
resp.raise_for_status()
print(resp.json())
const resp = await fetch(
  'https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mwt_live_YOUR_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({"energy_type":"gravitational","solve_for":"energy","mass":2,"height":3,"planet":"earth","energy_unit":"J","mass_unit":"kg","height_unit":"m","spring_unit":"Nm","displacement_unit":"m"}),
  }
);
const data = await resp.json();
console.log(data);
<?php
$ch = curl_init('https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mwt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'energy_type' => 'gravitational',
    'solve_for' => 'energy',
    'mass' => 2,
    'height' => 3,
    'planet' => 'earth',
    'energy_unit' => 'J',
    'mass_unit' => 'kg',
    'height_unit' => 'm',
    'spring_unit' => 'Nm',
    'displacement_unit' => 'm'
]),
]);
$resp = curl_exec($ch);
curl_close($ch);
print_r(json_decode($resp, true));
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == 'https')

req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mwt_live_YOUR_KEY'
req['Content-Type'] = 'application/json'
req.body = {
  'energy_type' => 'gravitational',
  'solve_for' => 'energy',
  'mass' => 2,
  'height' => 3,
  'planet' => 'earth',
  'energy_unit' => 'J',
  'mass_unit' => 'kg',
  'height_unit' => 'm',
  'spring_unit' => 'Nm',
  'displacement_unit' => 'm'
}.to_json

resp = http.request(req)
puts JSON.parse(resp.body).inspect
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  body, _ := json.Marshal(map[string]interface{}{
    "energy_type": "gravitational",
    "solve_for": "energy",
    "mass": 2,
    "height": 3,
    "planet": "earth",
    "energy_unit": "J",
    "mass_unit": "kg",
    "height_unit": "m",
    "spring_unit": "Nm",
    "displacement_unit": "m",
  })
  req, _ := http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run", bytes.NewReader(body))
  req.Header.Set("Authorization", "Bearer mwt_live_YOUR_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  out, _ := io.ReadAll(resp.Body)
  fmt.Println(string(out))
}
import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run"))
    .header("Authorization", "Bearer mwt_live_YOUR_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"energy_type\":\"gravitational\",\"solve_for\":\"energy\",\"mass\":2,\"height\":3,\"planet\":\"earth\",\"energy_unit\":\"J\",\"mass_unit\":\"kg\",\"height_unit\":\"m\",\"spring_unit\":\"Nm\",\"displacement_unit\":\"m\"}"))
    .build();

var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

How to call Potential Energy Calculator

  1. 1 Get an API key
    Get an API key. Sign up free for a bearer token. 1,000 credits/month, no card.
  2. 2 Assemble the JSON body
    Required fields: . See the Request body table below for the full schema.
  3. 3 POST to https://api.miniwebtool.com/v1/tools/potential-energy-calculator/run
    Headers: Authorization: Bearer <key> and Content-Type: application/json. Copy-paste snippets in 7 languages are under Code examples.
  4. 4 Parse the response
    Envelope: {request_id, tool, tool_version, credits_used, result}. The typed output lives in result.

Frequently asked

What does the Potential Energy Calculator API do?

Calculate gravitational or elastic potential energy and solve for missing variables. Use it when you need exact JSON instead of asking an LLM to recreate well-defined utility logic.

How much does one call to Potential Energy Calculator cost?

1 credit per successful call. Failed calls (validation errors, 5xx) don't bill.

What parameters does the Potential Energy Calculator API require?

Required fields: (none). Full schema at /v1/openapi.json.

Is the Potential Energy Calculator API deterministic?

Yes — same input, same output, forever. Tool version 2026-04-22; output shape is stable within a major version.

Can an AI agent call the Potential Energy Calculator API?

Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `potential-energy-calculator` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result.

What format does the API return?

JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`.

Use from an AI agent

Every endpoint on this site is also exposed via the Model Context Protocol at https://api.miniwebtool.com/v1/mcp. Claude, Cursor, and any MCP-capable agent can discover this tool (potential-energy-calculator) and its JSON Schema automatically — no client codegen.

# List tools the agent can call
curl -s https://api.miniwebtool.com/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
 | jq '.result.tools[] | select(.name=="potential-energy-calculator")'

Related science tools

psi to kPa Converter
Convert pounds per square inch to kilopascals and related pressure units.
Bar to PSI Converter
Convert bar and PSI, including kPa, MPa, atm, torr, inHg, and Pa.
555 Timer Calculator
Calculate 555 timer astable frequency, period, duty cycle, or monostable pulse …
Astronomical Unit Converter
Convert astronomical distances among AU, light-time, parsecs, kilometers, and m…