API & MCP
Everything a person can do on Pocketlab, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
GET https://pocketlab.usefulweb.site/api/v1/tools– catalogGET https://pocketlab.usefulweb.site/api/v1/tools/{id}– inputs, output schema, examplesPOST https://pocketlab.usefulweb.site/api/v1/tools/{id}/calculate– run a toolGET https://pocketlab.usefulweb.site/api/v1/workflows·POST https://pocketlab.usefulweb.site/api/v1/workflows/{id}/run- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Tools on Pocketlab
- Pocketlab GPS Trip Stats (GPX → speed and distance) – GPX track in: distance, moving time, average and maximum speed, climb and km splits.
ohmforge_gps_trip_stats - Pocketlab Magnetic Declination (WMM2025) – Magnetic declination, inclination and field strength for any place and date (2025–2030).
ohmforge_magnetic_declination - Pocketlab Sound Level (WAV → Leq, LAeq, Lmax) – Upload a WAV recording: A/C/Z-weighted Leq, Fast/Slow Lmax, peak and L10/L50/L90.
ohmforge_sound_level - Pocketlab Vibration Spectrum (accelerometer CSV) – Accelerometer CSV in, vibration spectrum out: peak frequencies, amplitudes, rpm and RMS.
ohmforge_vibration_spectrum - Pocketlab Step Counter (accelerometer CSV) – Count steps in an accelerometer recording: steps, cadence, distance and steps per minute.
pocketlab_step_counter - Pocketlab Seismograph (accelerometer CSV → peaks and events) – Peak and RMS shaking, a seismogram trace and STA/LTA events from an accelerometer recording.
pocketlab_seismograph - Pocketlab Slope Converter (degrees, %, 1:n, mm/m) – Convert a slope between degrees, percent grade, 1 : n ratio and millimetres per metre.
pocketlab_slope_converter - Pocketlab Light & Exposure Converter (lux ↔ EV ↔ shutter) – Convert lux to exposure value and back, and get shutter speeds for common f-numbers.
pocketlab_light_exposure - Skyfold Sun Position and Shadow Length – Sun angle and the length and direction of a shadow for any height, place and time.
skyfold_sun_shadow - Skyfold Planet and Moon Positions – Where the Sun, Moon and planets are, and when they rise and set, for any place and time.
skyfold_planet_positions - Tuning Reference (String Frequencies & Temperaments) – String frequencies for guitar, bass, violin and more at any A4, in equal or historical temperaments.
tonegrid_tuning_reference - RavingDesk GPS File Converter (GPX ↔ KML ↔ GeoJSON) – Convert GPX, KML and GeoJSON, simplify tracks and get length, climb, descent and duration.
ravingdesk_gps_file_converter
Every result contains
inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.
MCP (Model Context Protocol)
- Streamable HTTP endpoint:
https://pocketlab.usefulweb.site/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
ohmforge_gps_trip_stats,ohmforge_magnetic_declination,ohmforge_sound_level,ohmforge_vibration_spectrum,pocketlab_step_counter,pocketlab_seismograph,pocketlab_slope_converter,pocketlab_light_exposure,skyfold_sun_shadow,skyfold_planet_positions,tonegrid_tuning_reference,ravingdesk_gps_file_converter - Local stdio connector:
node src/mcp-stdio.ts
{
"mcpServers": {
"usefulweb": { "type": "http", "url": "https://pocketlab.usefulweb.site/mcp" }
}
}