Shreddy
Measured mountain bike jumps and speeds at bike parks: public clips, read-only.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~8,013Tokens (tool definitions)
~17.9 KBTypical response size
Significant attention impact (6.26% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"shreddy": {
"url": "https://api.shreddy.ai/mcp"
}
}
}Remote endpoints
https://api.shreddy.ai/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢list_venues(query, near, limit)
List the bike parks (venues) that have public Shreddy clips: name, city, state, how many clips and how many measured rides, the runs and features there, and a link. Filter by `query` (matches name, city or state) or sort nearest first with `near` (coordinates; for a place name like "San Diego", pass its approximate latitude and longitude). Distances come in km and miles. Use it for "what parks do you have" and to learn valid venue names.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Free text matched against venue name, city and state, e.g. \"bradley\" or \"CA\".",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"near": {
"description": "Sort by distance from this point (decimal degrees). For a city, pass its approximate coordinates.",
"type": "object",
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"long": {
"type": "number",
"minimum": -180,
"maximum": 180
}
},
"required": [
"lat",
"long"
],
"additionalProperties": false
},
"limit": {
"description": "How many venues to return (1 to 25, default 25).",
"type": "integer",
"minimum": 1,
"maximum": 25
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"venues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"link": {
"type": "string",
"minLength": 1
},
"clip_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"runs": {
"type": "array",
"items": {
"type": "string"
}
},
"features": {
"type": "array",
"items": {
"type": "string"
}
},
"distance_km": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"distance_mi": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"name",
"city",
"state",
"link",
"clip_count",
"measured_count",
"runs",
"features",
"distance_km",
"distance_mi"
],
"additionalProperties": false
}
}
},
"required": [
"message",
"venues"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_venue(venue)
Everything about one bike park in one call: its runs and their features (with clip counts), how many public clips and measured rides it has, its records (the top 3 public rides for jump height, jump length, airtime and speed, biggest first) and its newest clips, each with a link. `venue` is a name ("bradley", "snow summit") or an id.
Input Schema
{
"type": "object",
"properties": {
"venue": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 2147483647
}
],
"description": "A bike park name (\"bradley\", \"Snow Summit\") or its id."
}
},
"required": [
"venue"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"ambiguous",
"no_match"
]
},
"message": {
"type": "string"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"venue",
"run",
"feature",
"rider"
]
},
"id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"venue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"id",
"name",
"venue"
],
"additionalProperties": false
}
},
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"link": {
"type": "string",
"minLength": 1
},
"clip_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"runs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"features": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"clip_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"name",
"type",
"clip_count"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"features"
],
"additionalProperties": false
}
},
"other_features": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"clip_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"name",
"type",
"clip_count"
],
"additionalProperties": false
}
},
"records": {
"type": "object",
"properties": {
"jump_height": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"link": {
"type": "string",
"minLength": 1
},
"date": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"link": {
"type": "string",
"minLength": 1
}
},
"required": [
"id",
"name",
"link"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"feature": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_train": {
"type": "boolean"
},
"riders_in_clip": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"jump_height_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"jump_length_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"airtime_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_kmh": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_mph": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"jump_height_m",
"jump_length_m",
"airtime_s",
"speed_kmh",
"speed_mph"
],
"additionalProperties": false
},
"rank": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"thumbnail": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"link",
"date",
"venue",
"run",
"feature",
"rider",
"is_train",
"riders_in_clip",
"measured",
"stats",
"rank",
"thumbnail"
],
"additionalProperties": false
}
},
"jump_length": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"link": {
"type": "string",
"minLength": 1
},
"date": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"link": {
"type": "string",
"minLength": 1
}
},
"required": [
"id",
"name",
"link"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"feature": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_train": {
"type": "boolean"
},
"riders_in_clip": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"jump_height_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"jump_length_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"airtime_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_kmh": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_mph": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"jump_height_m",
"jump_length_m",
"airtime_s",
"speed_kmh",
"speed_mph"
],
"additionalProperties": false
},
"rank": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"thumbnail": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"link",
"date",
"venue",
"run",
"feature",
"rider",
"is_train",
"riders_in_clip",
"measured",
"stats",
"rank",
"thumbnail"
],
"additionalProperties": false
}
},
"airtime": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"link": {
"type": "string",
"minLength": 1
},
"date": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"link": {
"type": "string",
"minLength": 1
}
},
"required": [
"id",
"name",
"link"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"feature": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_train": {
"type": "boolean"
},
"riders_in_clip": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"jump_height_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"jump_length_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"airtime_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_kmh": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_mph": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"jump_height_m",
"jump_length_m",
"airtime_s",
"speed_kmh",
"speed_mph"
],
"additionalProperties": false
},
"rank": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"thumbnail": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"link",
"date",
"venue",
"run",
"feature",
"rider",
"is_train",
"riders_in_clip",
"measured",
"stats",
"rank",
"thumbnail"
],
"additionalProperties": false
}
},
"speed": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"link": {
"type": "string",
"minLength": 1
},
"date": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"link": {
"type": "string",
"minLength": 1
}
},
"required": [
"id",
"name",
"link"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"feature": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_train": {
"type": "boolean"
},
"riders_in_clip": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"jump_height_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"jump_length_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"airtime_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_kmh": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_mph": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"jump_height_m",
"jump_length_m",
"airtime_s",
"speed_kmh",
"speed_mph"
],
"additionalProperties": false
},
"rank": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"thumbnail": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"link",
"date",
"venue",
"run",
"feature",
"rider",
"is_train",
"riders_in_clip",
"measured",
"stats",
"rank",
"thumbnail"
],
"additionalProperties": false
}
}
},
"required": [
"jump_height",
"jump_length",
"airtime",
"speed"
],
"additionalProperties": false
},
"latest": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"link": {
"type": "string",
"minLength": 1
},
"date": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"link": {
"type": "string",
"minLength": 1
}
},
"required": [
"id",
"name",
"link"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"feature": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_train": {
"type": "boolean"
},
"riders_in_clip": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"jump_height_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"jump_length_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"airtime_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_kmh": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_mph": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"jump_height_m",
"jump_length_m",
"airtime_s",
"speed_kmh",
"speed_mph"
],
"additionalProperties": false
},
"rank": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"thumbnail": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"link",
"date",
"venue",
"run",
"feature",
"rider",
"is_train",
"riders_in_clip",
"measured",
"stats",
"rank",
"thumbnail"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"city",
"state",
"link",
"clip_count",
"measured_count",
"runs",
"other_features",
"records",
"latest"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"message",
"candidates",
"venue"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_clips(venue, feature, rider, when, since, ...)
Search public clips. Newest first by default; sort "biggest" or "smallest" with a `metric` for the biggest jumps, longest jumps, most airtime or fastest runs (ranked results list each rider of a group clip on their own, and leave out rides with no value for that metric). Filter by `venue`, `feature` (a feature or a run at the venue, e.g. "double black" or "jump 2"), `rider`, and time (`when`, or `since`/`until`). A newest search includes clips with no measurements (normal: no calibration). Every clip has a link to give the viewer. Pass `next_cursor` back as `cursor`, with the same other arguments, for the next page.
Input Schema
{
"type": "object",
"properties": {
"venue": {
"description": "A bike park name (\"bradley\", \"Snow Summit\") or its id.",
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 2147483647
}
]
},
"feature": {
"description": "A feature or a run at the venue, by name (\"jump 2\", \"double black\") or id. Works without a venue too.",
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 100
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 2147483647
}
]
},
"rider": {
"description": "A rider's name. Only riders who linked their account and allow it can be found.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"when": {
"description": "today = the last 24 hours, week = the last 7 days, month = the last 30 days, all (default). since/until override it.",
"type": "string",
"enum": [
"today",
"week",
"month",
"all"
]
},
"since": {
"description": "Only clips filmed at or after this ISO date (2026-09-01) or datetime.",
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
]
},
"until": {
"description": "Only clips filmed at or before this ISO date (the whole day counts) or datetime.",
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
]
},
"sort": {
"description": "newest (default), or biggest / smallest by `metric`. Giving a metric without a sort means biggest.",
"type": "string",
"enum": [
"newest",
"biggest",
"smallest"
]
},
"metric": {
"description": "What to rank by: jump_height (default when ranked), jump_length, airtime, or speed.",
"type": "string",
"enum": [
"jump_height",
"jump_length",
"speed",
"airtime"
]
},
"limit": {
"description": "How many clips (1 to 25, default 10).",
"type": "integer",
"minimum": 1,
"maximum": 25
},
"cursor": {
"description": "The next_cursor from the previous page of the same search.",
"type": "string",
"minLength": 1,
"maxLength": 512
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"ambiguous",
"no_match"
]
},
"message": {
"type": "string"
},
"resolved": {
"type": "object",
"properties": {
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"link": {
"type": "string",
"minLength": 1
}
},
"required": [
"id",
"name",
"link"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"feature": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"venue",
"run",
"feature",
"rider"
],
"additionalProperties": false
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"venue",
"run",
"feature",
"rider"
]
},
"id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"venue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"id",
"name",
"venue"
],
"additionalProperties": false
}
},
"query": {
"type": "object",
"properties": {
"sort": {
"type": "string",
"enum": [
"newest",
"biggest",
"smallest"
]
},
"metric": {
"anyOf": [
{
"type": "string",
"enum": [
"jump_height",
"jump_length",
"speed",
"airtime"
]
},
{
"type": "null"
}
]
},
"since": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
},
"until": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25
}
},
"required": [
"sort",
"metric",
"since",
"until",
"limit"
],
"additionalProperties": false
},
"clips": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"link": {
"type": "string",
"minLength": 1
},
"date": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"link": {
"type": "string",
"minLength": 1
}
},
"required": [
"id",
"name",
"link"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"feature": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_train": {
"type": "boolean"
},
"riders_in_clip": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"jump_height_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"jump_length_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"airtime_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_kmh": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_mph": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"jump_height_m",
"jump_length_m",
"airtime_s",
"speed_kmh",
"speed_mph"
],
"additionalProperties": false
},
"rank": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"thumbnail": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"link",
"date",
"venue",
"run",
"feature",
"rider",
"is_train",
"riders_in_clip",
"measured",
"stats",
"rank",
"thumbnail"
],
"additionalProperties": false
}
},
"total": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"message",
"resolved",
"candidates",
"query",
"clips",
"total",
"next_cursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_clip(id)
One public clip by id: where and when it was filmed, the rider if named, every measurement, how it was calibrated, and for a group clip (a train of riders) each rider with their own stats and link. A clip that is private, removed or does not exist all read as not found.
Input Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 2147483647
},
{
"type": "string",
"minLength": 1,
"maxLength": 10
}
],
"description": "The clip id (the number in https://www.shreddy.ai/clips/<id>)."
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"link": {
"type": "string",
"minLength": 1
},
"date": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"venue": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"link": {
"type": "string",
"minLength": 1
}
},
"required": [
"id",
"name",
"link"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"run": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"feature": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"is_train": {
"type": "boolean"
},
"riders_in_clip": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"measured": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"jump_height_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"jump_length_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"airtime_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_kmh": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_mph": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"jump_height_m",
"jump_length_m",
"airtime_s",
"speed_kmh",
"speed_mph"
],
"additionalProperties": false
},
"rank": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"thumbnail": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
},
"setup": {
"type": "object",
"properties": {
"origin": {
"anyOf": [
{
"type": "string",
"enum": [
"reused",
"created"
]
},
{
"type": "null"
}
]
},
"version": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"scale": {
"anyOf": [
{
"type": "string",
"enum": [
"measured_line",
"automatic"
]
},
{
"type": "null"
}
]
}
},
"required": [
"origin",
"version",
"scale"
],
"additionalProperties": false
},
"members": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"link": {
"type": "string",
"minLength": 1
},
"rider": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"measured": {
"type": "boolean"
},
"stats": {
"type": "object",
"properties": {
"jump_height_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"jump_length_m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"airtime_s": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_kmh": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"speed_mph": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"jump_height_m",
"jump_length_m",
"airtime_s",
"speed_kmh",
"speed_mph"
],
"additionalProperties": false
}
},
"required": [
"id",
"link",
"rider",
"measured",
"stats"
],
"additionalProperties": false
}
},
"message": {
"type": "string"
}
},
"required": [
"id",
"link",
"date",
"venue",
"run",
"feature",
"rider",
"is_train",
"riders_in_clip",
"measured",
"stats",
"rank",
"thumbnail",
"setup",
"members",
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded4 tools