API Documentation

Integrate unit conversions into your applications with our free API. Enable AI assistants to perform conversions using our MCP server.

AI-Powered Unit ConversionMCP
Convert2 provides a Model Context Protocol (MCP) server that allows AI assistants to perform accurate unit conversions directly. Compatible with Claude Desktop, Cursor IDE, VS Code Copilot, and any MCP-compatible client.
62+
Categories
700+
Units
Free
No API Key
MCP
Protocol v2024-11-05
MCP Server ConfigurationAI Integration
Connect your AI assistant to Convert2 for seamless unit conversions. Choose your platform below for specific configuration instructions.

Claude Desktop Configuration

Add Convert2 to your Claude Desktop MCP configuration file at ~/.claude/mcp.json

{
  "mcpServers": {
    "convert2": {
      "url": "https://convert2.example.com/api/mcp",
      "transport": "http",
      "enabled_tools": ["convert_units", "list_categories", "list_units", "search_units"],
      "tool_timeout_sec": 30
    }
  }
}

After saving, restart Claude Desktop. You can then ask Claude to convert units naturally, e.g., "Convert 100 meters to feet".

Available MCP Tools
Four tools are available for AI assistants to perform unit conversions

convert_unitsPrimary

Convert a value from one unit to another

{
  "value": 100,
  "category": "length",
  "fromUnit": "meter",
  "toUnit": "foot"
}

list_categories

List all 62 conversion categories

// No parameters required
// Returns: categories[], totalCategories

list_units

List all units in a specific category

{
  "category": "temperature"
}

search_units

Search for units by name or symbol

{
  "query": "gallon"
}
REST APIFree
Simple REST endpoints for direct integration into any application

Convert Units

GET/api/convert?category=length&from=meter&to=foot&value=100

Parameters

categoryThe conversion category (e.g., "length", "weight")
fromThe source unit ID (e.g., "meter")
toThe target unit ID (e.g., "foot")
valueThe numeric value to convert

Batch Conversions

POST/api/convert
[
  { "category": "length", "from": "meter", "to": "foot", "value": 100 },
  { "category": "weight", "from": "kilogram", "to": "pound", "value": 50 }
]

List Categories

GET/api/categories

Returns all 62 categories with their available units.

Available Categories
All 62 conversion categories supported by the API
length
22 units
weight
19 units
temperature
8 units
area
17 units
volume
26 units
pressure
19 units
energy
21 units
power
20 units
force
17 units
time
19 units
speed
17 units
angle
16 units
fuel-consumption
8 units
data-storage
24 units
data-transfer
16 units
frequency
13 units
acceleration
12 units
acceleration-angular
5 units
torque
13 units
moment-of-inertia
8 units
density
14 units
flow
19 units
flow-mass
13 units
viscosity-dynamic
12 units
viscosity-kinematic
8 units
specific-volume
8 units
velocity-angular
11 units
charge
13 units
current
10 units
voltage
8 units
resistance
9 units
conductance
8 units
capacitance
8 units
inductance
10 units
magnetic-flux
9 units
magnetic-flux-density
11 units
magnetic-field-strength
6 units
magnetomotive-force
4 units
radiation
7 units
radiation-activity
13 units
radiation-exposure
6 units
radiation-absorbed-dose
8 units
luminance
16 units
luminous-intensity
9 units
illumination
12 units
digital-image-resolution
6 units
frequency-wavelength
18 units
thermal-conductivity
7 units
thermal-resistance
4 units
heat-capacity
8 units
heat-flux-density
10 units
thermal-expansion
4 units
heat-transfer-coefficient
6 units
heat-density
7 units
sound
3 units
sound-intensity
4 units
volume-dry
14 units
typography
13 units
prefix
25 units
surface-tension
5 units
permeability
7 units
concentration-molar
9 units
Rate Limits & Usage
Free TierUnlimited requests (fair use)
No API KeyOpen API for public use
CORS EnabledCall from any domain