Gridleak is an MCP server published by app.gridleak, hosted at api.gridleak.app. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 12 tools, including search_presets, get_preset, list_manufacturers, get_amp, compare_amps.
Real guitar amps, their circuits and modeler presets for Quad Cortex, Axe-Fx, FM3, FM9 and Helix.
13 connections through 4 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Search the Gridleak guitar amp preset library. Returns matching presets with manufacturer, model, device, and confidence information. Excludes experimental and AI-generated presets by default. Each preset is built from the amp's own schematic for Quad Cortex, Axe-Fx II, Axe-Fx III, FM3, FM9 and Helix.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return (default 20, max 50). |
| query | string | Free-text search matched against manufacturer and model name. |
| device | string | Filter results to a specific modeler device. |
| manufacturer | string | Partial manufacturer name filter (e.g. 'Fender', 'Marshall'). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "search_presets",
"title": "Search presets",
"description": "Search the Gridleak guitar amp preset library. Returns matching presets with manufacturer, model, device, and confidence information. Excludes experimental and AI-generated presets by default. Each preset is built from the amp's own schematic for Quad Cortex, Axe-Fx II, Axe-Fx III, FM3, FM9 and Helix.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results to return (default 20, max 50)."
},
"query": {
"type": "string",
"description": "Free-text search matched against manufacturer and model name."
},
"device": {
"enum": [
"quadcortex",
"axefx2",
"axefx3",
"fm3",
"fm9",
"helix"
],
"type": "string",
"description": "Filter results to a specific modeler device."
},
"manufacturer": {
"type": "string",
"description": "Partial manufacturer name filter (e.g. 'Fender', 'Marshall')."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"PresetRow": {
"type": "object",
"title": "PresetRow",
"required": [
"provenance"
],
"properties": {
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"device": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Device",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"canonical_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Canonical Id",
"default": null
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"confidence_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Confidence Tier",
"default": null
},
"confidence_score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Confidence Score",
"default": null
}
},
"additionalProperties": true
},
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "SearchPresetsAnswer",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"$ref": "#/$defs/PresetRow"
},
"title": "Result"
}
}
},
"annotations": {
"title": "Search presets",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Fetch a single preset by its canonical_id. Returns manufacturer, model, confidence tier, and available devices.
| Parameter | Type | Description |
|---|---|---|
| canonical_id * | string | The preset's unique canonical identifier (e.g. 'fender/twin_reverb' or 'marshall/jcm800'). |
{
"name": "get_preset",
"title": "Get a preset",
"description": "Fetch a single preset by its canonical_id. Returns manufacturer, model, confidence tier, and available devices.",
"inputSchema": {
"type": "object",
"required": [
"canonical_id"
],
"properties": {
"canonical_id": {
"type": "string",
"description": "The preset's unique canonical identifier (e.g. 'fender/twin_reverb' or 'marshall/jcm800')."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "PresetAnswer",
"required": [
"provenance"
],
"properties": {
"tags": {
"title": "Tags",
"default": null
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"devices": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"title": "Devices",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"canonical_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Canonical Id",
"default": null
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"confidence_tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Confidence Tier",
"default": null
},
"confidence_score": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Confidence Score",
"default": null
}
},
"description": "get_preset: clean metadata (never r2_key), or {\"error\": \"preset not found\", provenance}.",
"additionalProperties": true
},
"annotations": {
"title": "Get a preset",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List guitar amp manufacturers in the Gridleak library, sorted by unique amp count descending. Useful for discovering what brands are available.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of manufacturers to return (default 50, max 100). |
{
"name": "list_manufacturers",
"title": "List amp makers",
"description": "List guitar amp manufacturers in the Gridleak library, sorted by unique amp count descending. Useful for discovering what brands are available.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum number of manufacturers to return (default 50, max 100)."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"MakerRow": {
"type": "object",
"title": "MakerRow",
"required": [
"provenance"
],
"properties": {
"count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Count",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
}
},
"additionalProperties": true
},
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "ManufacturersAnswer",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"$ref": "#/$defs/MakerRow"
},
"title": "Result"
}
}
},
"annotations": {
"title": "List amp makers",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Look up one real guitar amp in Gridleak's catalog and get its canonical record: name, manufacturer, years, origin, wattage, channels, preamp and power tubes, notable players, short history, the factory amp models on Quad Cortex / Axe-Fx III, FM9, FM3 / Axe-Fx II / Helix that are this exact amp, whether Gridleak has a verified schematic of it (public summary only: stage titles, part count, verification status), which modelers have a Gridleak preset for it, and the amp-vs-amp comparison pages it appears in. Every result links to its gridleak.app page. Use this to answer questions about a specific amp ("what tubes does a JCM800 use?", "what is the Brit 2204 based on?"). Accepts a canonical id, an amp name, or a modeler's factory model name. Covers guitar amps from Fender, Marshall, Mesa/Boogie, Vox and hundreds of other makers, vintage and modern.
| Parameter | Type | Description |
|---|---|---|
| amp * | string | The amp: a canonical id ('marshall/jcm800_2204'), an amp name ('JCM800 2204', 'Fender Bassman'), or a modeler factory model name ('Brit 2204', 'Recto1 Org Mdrn'). |
| modeler | string | The player's modeler, when they name it ('I play a Helix' -> helix; HX Stomp -> helix). The answer then opens on that modeler's preset. Without it, a signed-in player's saved modeler is used. |
{
"name": "get_amp",
"title": "Get an amp",
"description": "Look up one real guitar amp in Gridleak's catalog and get its canonical record: name, manufacturer, years, origin, wattage, channels, preamp and power tubes, notable players, short history, the factory amp models on Quad Cortex / Axe-Fx III, FM9, FM3 / Axe-Fx II / Helix that are this exact amp, whether Gridleak has a verified schematic of it (public summary only: stage titles, part count, verification status), which modelers have a Gridleak preset for it, and the amp-vs-amp comparison pages it appears in. Every result links to its gridleak.app page. Use this to answer questions about a specific amp (\"what tubes does a JCM800 use?\", \"what is the Brit 2204 based on?\"). Accepts a canonical id, an amp name, or a modeler's factory model name. Covers guitar amps from Fender, Marshall, Mesa/Boogie, Vox and hundreds of other makers, vintage and modern.",
"inputSchema": {
"type": "object",
"required": [
"amp"
],
"properties": {
"amp": {
"type": "string",
"description": "The amp: a canonical id ('marshall/jcm800_2204'), an amp name ('JCM800 2204', 'Fender Bassman'), or a modeler factory model name ('Brit 2204', 'Recto1 Org Mdrn')."
},
"modeler": {
"enum": [
"quadcortex",
"axefx2",
"axefx3",
"fm3",
"fm9",
"helix"
],
"type": "string",
"description": "The player's modeler, when they name it ('I play a Helix' -> helix; HX Stomp -> helix). The answer then opens on that modeler's preset. Without it, a signed-in player's saved modeler is used."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
},
"FactoryModel": {
"type": "object",
"title": "FactoryModel",
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"device": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Device",
"default": null
},
"channel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Channel",
"default": null
},
"based_on": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Based On",
"default": null
},
"device_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Device Label",
"default": null
},
"factory_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Factory Model",
"default": null
},
"unofficial_list": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Unofficial List",
"default": null
}
},
"additionalProperties": true
},
"SchematicTeaser": {
"type": "object",
"title": "SchematicTeaser",
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"access": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Access",
"default": null
},
"stages": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Stages",
"default": null
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Verified",
"default": null
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Available",
"default": null
},
"part_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Part Count",
"default": null
},
"stage_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Stage Count",
"default": null
},
"verification_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Verification Status",
"default": null
}
},
"additionalProperties": true
}
},
"title": "AmpAnswer",
"required": [
"provenance"
],
"properties": {
"era": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Era",
"default": null
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"lore": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Lore",
"default": null
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"years": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Years",
"default": null
},
"origin": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Origin",
"default": null
},
"modeler": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Modeler",
"default": null
},
"presets": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Presets",
"default": null
},
"wattage": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Wattage",
"default": null
},
"channels": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Channels",
"default": null
},
"schematic": {
"anyOf": [
{
"$ref": "#/$defs/SchematicTeaser"
},
{
"type": "null"
}
],
"default": null
},
"matched_by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Matched By",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"search_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search Url",
"default": null
},
"comparisons": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Comparisons",
"default": null
},
"power_tubes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Power Tubes",
"default": null
},
"amp_channels": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"title": "Amp Channels",
"default": null
},
"canonical_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Canonical Id",
"default": null
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
},
"preamp_tubes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Preamp Tubes",
"default": null
},
"notable_users": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"title": "Notable Users",
"default": null
},
"factory_models": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/FactoryModel"
}
},
{
"type": "null"
}
],
"title": "Factory Models",
"default": null
},
"iconic_recordings": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"title": "Iconic Recordings",
"default": null
}
},
"description": "get_amp: the canonical amp record, or answers.missing (error, search_url).",
"additionalProperties": true
},
"annotations": {
"title": "Get an amp",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Compare two real guitar amps. If Gridleak has published a comparison page for the pair (built stage by stage from verified schematics of both amps), returns its summary, the key circuit differences, a spec table and the gridleak.app/compare URL. If not, returns each amp's own record facts side by side (years, origin, wattage, tubes, players) with no invented differences, and says there is no full comparison page yet. Use for "X vs Y" or "how is X different from Y" questions. Each amp may be a canonical id, an amp name, or a factory model name.
| Parameter | Type | Description |
|---|---|---|
| a * | string | First amp: canonical id, amp name, or factory model name (e.g. 'Bassman'). |
| b * | string | Second amp: canonical id, amp name, or factory model name (e.g. 'JTM45'). |
{
"name": "compare_amps",
"title": "Compare amps",
"description": "Compare two real guitar amps. If Gridleak has published a comparison page for the pair (built stage by stage from verified schematics of both amps), returns its summary, the key circuit differences, a spec table and the gridleak.app/compare URL. If not, returns each amp's own record facts side by side (years, origin, wattage, tubes, players) with no invented differences, and says there is no full comparison page yet. Use for \"X vs Y\" or \"how is X different from Y\" questions. Each amp may be a canonical id, an amp name, or a factory model name.",
"inputSchema": {
"type": "object",
"required": [
"a",
"b"
],
"properties": {
"a": {
"type": "string",
"description": "First amp: canonical id, amp name, or factory model name (e.g. 'Bassman')."
},
"b": {
"type": "string",
"description": "Second amp: canonical id, amp name, or factory model name (e.g. 'JTM45')."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"AmpRef": {
"type": "object",
"title": "AmpRef",
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null
},
"canonical_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Canonical Id",
"default": null
}
},
"additionalProperties": true
},
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "CompareAnswer",
"required": [
"provenance"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"amps": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/AmpRef"
}
},
{
"type": "null"
}
],
"title": "Amps",
"default": null
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"specs": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Specs",
"default": null
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Title",
"default": null
},
"counts": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Counts",
"default": null
},
"summary": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Summary",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"search_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search Url",
"default": null
},
"comparison_page": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Comparison Page",
"default": null
},
"key_differences": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Key Differences",
"default": null
}
},
"description": "compare_amps: a published comparison page, both records side by side, or answers.missing.",
"additionalProperties": true
},
"annotations": {
"title": "Compare amps",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Translate between real amps and modeler factory amp models. Given a real amp ("Dual Rectifier", "Vox AC30"), returns the factory amp models on each modeler (or on one device) whose maker says they are that exact amp. Given a factory model name ("Brit 2204", "Cali Rectifire", "Class-A 30W TB"), returns the real amp it is, with a link to its gridleak.app page. Only exact twins are listed, never nearest-sounding models. Devices: quadcortex, axefx3 (the Axe-Fx III, FM9 and FM3 share one list; fm9 and fm3 are accepted too), axefx2, helix.
| Parameter | Type | Description |
|---|---|---|
| query * | string | A real amp (name or canonical id) or a modeler's factory amp model name. |
| device | string | Optional: limit the answer to one modeler. |
{
"name": "find_modeler_equivalent",
"title": "Find the modeler equivalent",
"description": "Translate between real amps and modeler factory amp models. Given a real amp (\"Dual Rectifier\", \"Vox AC30\"), returns the factory amp models on each modeler (or on one device) whose maker says they are that exact amp. Given a factory model name (\"Brit 2204\", \"Cali Rectifire\", \"Class-A 30W TB\"), returns the real amp it is, with a link to its gridleak.app page. Only exact twins are listed, never nearest-sounding models. Devices: quadcortex, axefx3 (the Axe-Fx III, FM9 and FM3 share one list; fm9 and fm3 are accepted too), axefx2, helix.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "A real amp (name or canonical id) or a modeler's factory amp model name."
},
"device": {
"enum": [
"quadcortex",
"axefx3",
"fm9",
"fm3",
"axefx2",
"helix"
],
"type": "string",
"description": "Optional: limit the answer to one modeler."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"AmpRef": {
"type": "object",
"title": "AmpRef",
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null
},
"canonical_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Canonical Id",
"default": null
}
},
"additionalProperties": true
},
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "EquivalentAnswer",
"required": [
"provenance"
],
"properties": {
"amp": {
"anyOf": [
{
"$ref": "#/$defs/AmpRef"
},
{
"type": "null"
}
],
"default": null
},
"rule": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Rule",
"default": null
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"matches": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Matches",
"default": null
},
"direction": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Direction",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"search_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search Url",
"default": null
},
"equivalents": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Equivalents",
"default": null
},
"device_filter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Device Filter",
"default": null
}
},
"description": "find_modeler_equivalent: amp -> factory models (equivalents) or factory model -> amp (matches).",
"additionalProperties": true
},
"annotations": {
"title": "Find the modeler equivalent",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List the 15 modelers with a guide on gridleak.app/devices (Neural DSP Quad Cortex and Nano Cortex; Line 6 Helix Floor, LT, Rack, Stadium, Stadium XL, HX Stomp, HX Stomp XL, HX Effects, HX One; Fractal Audio Axe-Fx III, Axe-Fx II, FM9, FM3). Each entry has the modeler slug, name, maker, whether Gridleak installs presets on it from the browser, the device id used to filter presets, firmware covered, and the URL of each guide chapter (overview, presets, setup, learn, reference, models, fixes).
No parameters.
{
"name": "list_devices",
"title": "List modelers",
"description": "List the 15 modelers with a guide on gridleak.app/devices (Neural DSP Quad Cortex and Nano Cortex; Line 6 Helix Floor, LT, Rack, Stadium, Stadium XL, HX Stomp, HX Stomp XL, HX Effects, HX One; Fractal Audio Axe-Fx III, Axe-Fx II, FM9, FM3). Each entry has the modeler slug, name, maker, whether Gridleak installs presets on it from the browser, the device id used to filter presets, firmware covered, and the URL of each guide chapter (overview, presets, setup, learn, reference, models, fixes).",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$defs": {
"DeviceCard": {
"type": "object",
"title": "DeviceCard",
"required": [
"slug",
"name"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"form": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Form",
"default": null
},
"name": {
"type": "string",
"title": "Name"
},
"slug": {
"type": "string",
"title": "Slug"
},
"tabs": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Tabs",
"default": null
},
"maker": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Maker",
"default": null
},
"family": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Family",
"default": null
},
"firmware": {
"title": "Firmware",
"default": null
},
"installs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Installs",
"default": null
},
"preset_device": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Preset Device",
"default": null
}
},
"additionalProperties": true
},
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "DeviceListAnswer",
"required": [
"provenance",
"count",
"devices"
],
"properties": {
"next": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Next",
"default": null
},
"count": {
"type": "integer",
"title": "Count"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"devices": {
"type": "array",
"items": {
"$ref": "#/$defs/DeviceCard"
},
"title": "Devices"
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"installs_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Installs Note",
"default": null
}
},
"additionalProperties": true
},
"annotations": {
"title": "List modelers",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Device knowledge for one modeler: its five 'read this first' truths, its fixes (symptom, kind = fault or documented behaviour, causes in likelihood order, each with its fix), and assistant-only notes on how users commonly misread it. Every item carries a gridleak.app URL, source ids and a reliability tier (measured, official, retail, press, community, unverified); `sources` resolves the ids to labels and URLs. Use it when a user is stuck on, confused by, or deciding about one of these modelers.
| Parameter | Type | Description |
|---|---|---|
| topic | string | Optional. 'truths', 'fixes' or 'agent_notes' returns one section; any other text keeps only items containing every word (e.g. 'snapshots', 'usb audio'). |
| device * | string | Modeler slug from list_devices (e.g. 'helix-floor', 'hx-stomp', 'axe-fx-ii', 'quad-cortex') or its name ('Axe-Fx II', 'HX Stomp XL'). |
{
"name": "get_device_notes",
"title": "Get modeler notes",
"description": "Device knowledge for one modeler: its five 'read this first' truths, its fixes (symptom, kind = fault or documented behaviour, causes in likelihood order, each with its fix), and assistant-only notes on how users commonly misread it. Every item carries a gridleak.app URL, source ids and a reliability tier (measured, official, retail, press, community, unverified); `sources` resolves the ids to labels and URLs. Use it when a user is stuck on, confused by, or deciding about one of these modelers.",
"inputSchema": {
"type": "object",
"required": [
"device"
],
"properties": {
"topic": {
"type": "string",
"description": "Optional. 'truths', 'fixes' or 'agent_notes' returns one section; any other text keeps only items containing every word (e.g. 'snapshots', 'usb audio')."
},
"device": {
"type": "string",
"description": "Modeler slug from list_devices (e.g. 'helix-floor', 'hx-stomp', 'axe-fx-ii', 'quad-cortex') or its name ('Axe-Fx II', 'HX Stomp XL')."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"DeviceCard": {
"type": "object",
"title": "DeviceCard",
"required": [
"slug",
"name"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"form": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Form",
"default": null
},
"name": {
"type": "string",
"title": "Name"
},
"slug": {
"type": "string",
"title": "Slug"
},
"tabs": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Tabs",
"default": null
},
"maker": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Maker",
"default": null
},
"family": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Family",
"default": null
},
"firmware": {
"title": "Firmware",
"default": null
},
"installs": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Installs",
"default": null
},
"preset_device": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Preset Device",
"default": null
}
},
"additionalProperties": true
},
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "DeviceNotesAnswer",
"required": [
"provenance"
],
"properties": {
"hint": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Hint",
"default": null
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"fixes": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Fixes",
"default": null
},
"topic": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Topic",
"default": null
},
"counts": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Counts",
"default": null
},
"device": {
"anyOf": [
{
"$ref": "#/$defs/DeviceCard"
},
{
"type": "null"
}
],
"default": null
},
"truths": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Truths",
"default": null
},
"sources": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Sources",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"agent_notes": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Agent Notes",
"default": null
},
"devices_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Devices Url",
"default": null
},
"how_to_cite": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "How To Cite",
"default": null
},
"known_devices": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Known Devices",
"default": null
}
},
"description": "get_device_notes: one modeler's truths, fixes and agent notes, or the unknown-modeler answer.",
"additionalProperties": true
},
"annotations": {
"title": "Get modeler notes",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Puts a real amp's preset on the player's modeler: what 'put / load / send the <amp> on (or to) my <modeler>' asks for, on Axe-Fx II, Axe-Fx III, FM3, FM9 or Helix. With send_to_modeler it goes straight to the modeler connected in the player's open gridleak.app tab and loads into the edit buffer; no editor app (Axe-Edit, HX Edit) and no control of the computer is involved. Takes the amp's catalog id (canonical_id, e.g. 'marshall/jcm800_2204'). Without send_to_modeler it downloads the preset file. Returns a short-lived signed URL (valid 5 minutes) and preset metadata. Needs a Gridleak account. The player signs in when their assistant asks, or the client sends a Gridleak access token. Each new preset uses one of the account's monthly free presets; Pro has no monthly limit. Lead with install_url: it opens the preset on Gridleak, which installs it straight to the player's connected modeler or saves the file. Offer download_url as the direct file link. Don't fetch either yourself; assistant sandboxes usually can't reach them.
| Parameter | Type | Description |
|---|---|---|
| device * | string | Target modeler device for the download. |
| canonical_id * | string | The preset's canonical identifier, e.g. 'fender/twin_reverb'. |
| send_to_modeler | boolean | Send the preset straight to this modeler, connected in the player's open gridleak.app tab, instead of returning a file link. Use it only when the player asks to put a preset on their modeler. It loads into the edit buffer, with an undo in Gridleak; a saved slot, or a player who turned assistant send… |
{
"name": "download_preset",
"title": "Put a preset on a modeler",
"description": "Puts a real amp's preset on the player's modeler: what 'put / load / send the <amp> on (or to) my <modeler>' asks for, on Axe-Fx II, Axe-Fx III, FM3, FM9 or Helix. With send_to_modeler it goes straight to the modeler connected in the player's open gridleak.app tab and loads into the edit buffer; no editor app (Axe-Edit, HX Edit) and no control of the computer is involved. Takes the amp's catalog id (canonical_id, e.g. 'marshall/jcm800_2204'). Without send_to_modeler it downloads the preset file. Returns a short-lived signed URL (valid 5 minutes) and preset metadata. Needs a Gridleak account. The player signs in when their assistant asks, or the client sends a Gridleak access token. Each new preset uses one of the account's monthly free presets; Pro has no monthly limit. Lead with install_url: it opens the preset on Gridleak, which installs it straight to the player's connected modeler or saves the file. Offer download_url as the direct file link. Don't fetch either yourself; assistant sandboxes usually can't reach them.",
"inputSchema": {
"type": "object",
"required": [
"canonical_id",
"device"
],
"properties": {
"device": {
"enum": [
"axefx2",
"axefx3",
"fm3",
"fm9",
"helix"
],
"type": "string",
"description": "Target modeler device for the download."
},
"canonical_id": {
"type": "string",
"description": "The preset's canonical identifier, e.g. 'fender/twin_reverb'."
},
"send_to_modeler": {
"type": "boolean",
"description": "Send the preset straight to this modeler, connected in the player's open gridleak.app tab, instead of returning a file link. Use it only when the player asks to put a preset on their modeler. It loads into the edit buffer, with an undo in Gridleak; a saved slot, or a player who turned assistant sends off, confirms there. The answer's send.status is done, waiting (call again with the same arguments to check), declined, failed or no_tab (no tab with this modeler connected: lead with install_url). It counts as one free preset only when it installs."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"SendState": {
"type": "object",
"title": "SendState",
"required": [
"status"
],
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Id",
"default": null
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"where": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Where",
"default": null
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason",
"default": null
},
"status": {
"type": "string",
"title": "Status"
}
},
"description": "send_to_modeler (Phase 74.1): how the send to the player's open, connected gridleak.app tab stands.",
"additionalProperties": true
},
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
},
"QuotaState": {
"type": "object",
"title": "QuotaState",
"required": [
"plan"
],
"properties": {
"left": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Left",
"default": null
},
"plan": {
"type": "string",
"title": "Plan"
},
"used": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Used",
"default": null
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": null
}
},
"description": "The player's presets this month: plan \"pro\" (no limit) or \"free\" (limit and left).",
"additionalProperties": true
}
},
"title": "DownloadAnswer",
"required": [
"provenance"
],
"properties": {
"send": {
"anyOf": [
{
"$ref": "#/$defs/SendState"
},
{
"type": "null"
}
],
"default": null
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model",
"default": null
},
"quota": {
"anyOf": [
{
"$ref": "#/$defs/QuotaState"
},
{
"type": "null"
}
],
"default": null
},
"device": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Device",
"default": null
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message",
"default": null
},
"expires_in": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Expires In",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"account_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Account Url",
"default": null
},
"install_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Install Url",
"default": null
},
"canonical_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Canonical Id",
"default": null
},
"download_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Download Url",
"default": null
},
"manufacturer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manufacturer",
"default": null
}
},
"additionalProperties": true
},
"annotations": {
"title": "Put a preset on a modeler",
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}The amp behind a recording, and how to get that tone on a modeler. Given a song, an artist, or both, returns the amps Gridleak's Heard-on credits name for it (each credit is backed by the artist's own interview or two reputable sources), with the amp's era and years, its channel when the amp has only one, the factory amp models on the chosen modeler that are this exact amp, the Gridleak preset for that modeler with its install link, and the preset's Drive, Bass, Mid and Treble settings, each marked synthesised or unknown. When there is no sourced credit for the recording it says so, and lists the artist's other credits and the amps the artist is known for, separately. Modelers: quadcortex, axefx2, axefx3, fm3, fm9, helix, or a modeler name such as 'HX Stomp' or 'Quad Cortex'.
| Parameter | Type | Description |
|---|---|---|
| song | string | The song title, e.g. 'Rooster'. |
| artist | string | The artist or band, e.g. 'Alice In Chains'. Give a song, an artist, or both. |
| modeler | string | Optional: a device id (quadcortex, axefx2, axefx3, fm3, fm9, helix) or a modeler name ('HX Stomp', 'Quad Cortex'). |
{
"name": "get_song_tone",
"title": "Tone for a song",
"description": "The amp behind a recording, and how to get that tone on a modeler. Given a song, an artist, or both, returns the amps Gridleak's Heard-on credits name for it (each credit is backed by the artist's own interview or two reputable sources), with the amp's era and years, its channel when the amp has only one, the factory amp models on the chosen modeler that are this exact amp, the Gridleak preset for that modeler with its install link, and the preset's Drive, Bass, Mid and Treble settings, each marked synthesised or unknown. When there is no sourced credit for the recording it says so, and lists the artist's other credits and the amps the artist is known for, separately. Modelers: quadcortex, axefx2, axefx3, fm3, fm9, helix, or a modeler name such as 'HX Stomp' or 'Quad Cortex'.",
"inputSchema": {
"type": "object",
"properties": {
"song": {
"type": "string",
"description": "The song title, e.g. 'Rooster'."
},
"artist": {
"type": "string",
"description": "The artist or band, e.g. 'Alice In Chains'. Give a song, an artist, or both."
},
"modeler": {
"type": "string",
"description": "Optional: a device id (quadcortex, axefx2, axefx3, fm3, fm9, helix) or a modeler name ('HX Stomp', 'Quad Cortex')."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "SongToneAnswer",
"required": [
"provenance"
],
"properties": {
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"query": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"credits": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Credits",
"default": null
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message",
"default": null
},
"modeler": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Modeler",
"default": null
},
"known_for": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Known For",
"default": null
},
"browse_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Browse Url",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"closest_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Closest Note",
"default": null
},
"other_credits": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Other Credits",
"default": null
},
"not_in_catalog": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Not In Catalog",
"default": null
},
"closest_matches": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Closest Matches",
"default": null
},
"recording_found": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Recording Found",
"default": null
}
},
"description": "get_song_tone: the Heard-on credits for a recording or artist on a modeler, or the honest no-credit answer.",
"additionalProperties": true
},
"annotations": {
"title": "Tone for a song",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Where to find an exact amp and what it takes: marketplace and retailer search links, live listings when available, the tubes it uses (with a matched pair for the power tubes), parts and kits for restoring or building one, and the modelers that have a Gridleak preset for it. Given an artist, a song or a tone, returns the whole rig: up to three amps from Gridleak's Heard-on credits (for a tone: an artist's credits, an amp named exactly, or amps whose records carry the tone's words, each labelled), the preset for the chosen modeler with its install link and settings, the tubes, and where to find each. Guitars, pedals and cabinets are not covered. Modelers: quadcortex, axefx2, axefx3, fm3, fm9, helix, or a modeler name such as 'HX Stomp' or 'Quad Cortex'.
| Parameter | Type | Description |
|---|---|---|
| amp | string | A catalog id ('marshall/jcm800_2204'), an amp name ('Dual Rectifier') or a factory model name ('Brit 2204'). |
| song | string | A song title, e.g. 'Rooster'. |
| tone | string | A tone in plain words or an artist's name, e.g. 'high-gain british'. Give an amp, an artist, a song or a tone. |
| artist | string | An artist or band, e.g. 'Alice In Chains'. |
| modeler | string | Optional: a device id (quadcortex, axefx2, axefx3, fm3, fm9, helix) or a modeler name ('HX Stomp', 'Quad Cortex'). |
{
"name": "get_rig",
"title": "Rig for an amp or a song",
"description": "Where to find an exact amp and what it takes: marketplace and retailer search links, live listings when available, the tubes it uses (with a matched pair for the power tubes), parts and kits for restoring or building one, and the modelers that have a Gridleak preset for it. Given an artist, a song or a tone, returns the whole rig: up to three amps from Gridleak's Heard-on credits (for a tone: an artist's credits, an amp named exactly, or amps whose records carry the tone's words, each labelled), the preset for the chosen modeler with its install link and settings, the tubes, and where to find each. Guitars, pedals and cabinets are not covered. Modelers: quadcortex, axefx2, axefx3, fm3, fm9, helix, or a modeler name such as 'HX Stomp' or 'Quad Cortex'.",
"inputSchema": {
"type": "object",
"properties": {
"amp": {
"type": "string",
"description": "A catalog id ('marshall/jcm800_2204'), an amp name ('Dual Rectifier') or a factory model name ('Brit 2204')."
},
"song": {
"type": "string",
"description": "A song title, e.g. 'Rooster'."
},
"tone": {
"type": "string",
"description": "A tone in plain words or an artist's name, e.g. 'high-gain british'. Give an amp, an artist, a song or a tone."
},
"artist": {
"type": "string",
"description": "An artist or band, e.g. 'Alice In Chains'."
},
"modeler": {
"type": "string",
"description": "Optional: a device id (quadcortex, axefx2, axefx3, fm3, fm9, helix) or a modeler name ('HX Stomp', 'Quad Cortex')."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "RigAnswer",
"required": [
"provenance"
],
"properties": {
"amps": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Amps",
"default": null
},
"mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Mode",
"default": null
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"query": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message",
"default": null
},
"modeler": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Modeler",
"default": null
},
"rig_found": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Rig Found",
"default": null
},
"browse_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Browse Url",
"default": null
},
"disclosure": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Disclosure",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"search_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search Url",
"default": null
},
"family_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Family Note",
"default": null
},
"not_covered": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Not Covered",
"default": null
},
"closest_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Closest Note",
"default": null
},
"other_credits": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Other Credits",
"default": null
},
"not_in_catalog": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Not In Catalog",
"default": null
},
"closest_matches": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Closest Matches",
"default": null
},
"recording_found": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Recording Found",
"default": null
},
"recording_message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Recording Message",
"default": null
}
},
"description": "get_rig: where to find an amp, its tubes, parts, kits and modelers, or the rig for an artist, song or tone.",
"additionalProperties": true
},
"annotations": {
"title": "Rig for an amp or a song",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}The circuit of a real amp that Gridleak has redrawn from a verified schematic. For Gridleak Pro members: its stages, tone stack type and values with how it shapes the sound, coupling caps, negative feedback, rectifier and bias, and what each knob and switch does in this amp's circuit. Other callers get the stage titles, part count and verification status with a link to go pro for access. Accepts a canonical id, an amp name or a factory model name; give control to ask about one knob or switch.
| Parameter | Type | Description |
|---|---|---|
| amp * | string | A catalog id ('marshall/jcm800_2204'), an amp name ('Dual Rectifier') or a factory model name ('Brit 2204'). |
| control | string | Optional: one knob or switch by name, e.g. 'presence', 'bright' or 'channel 2 treble'. |
{
"name": "get_circuit",
"title": "Circuit of an amp",
"description": "The circuit of a real amp that Gridleak has redrawn from a verified schematic. For Gridleak Pro members: its stages, tone stack type and values with how it shapes the sound, coupling caps, negative feedback, rectifier and bias, and what each knob and switch does in this amp's circuit. Other callers get the stage titles, part count and verification status with a link to go pro for access. Accepts a canonical id, an amp name or a factory model name; give control to ask about one knob or switch.",
"inputSchema": {
"type": "object",
"required": [
"amp"
],
"properties": {
"amp": {
"type": "string",
"description": "A catalog id ('marshall/jcm800_2204'), an amp name ('Dual Rectifier') or a factory model name ('Brit 2204')."
},
"control": {
"type": "string",
"description": "Optional: one knob or switch by name, e.g. 'presence', 'bright' or 'channel 2 treble'."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"Provenance": {
"type": "object",
"title": "Provenance",
"required": [
"record_id",
"record_url",
"verification",
"basis"
],
"properties": {
"basis": {
"enum": [
"measured",
"derived_from_circuit",
"synthesised",
"catalog_record",
"unknown"
],
"type": "string",
"title": "Basis"
},
"record_id": {
"type": "string",
"title": "Record Id"
},
"record_url": {
"type": "string",
"title": "Record Url"
},
"last_checked": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Checked",
"default": null
},
"verification": {
"enum": [
"schematic_verified",
"catalog_verified",
"unverified"
],
"type": "string",
"title": "Verification"
}
},
"description": "Where an answer comes from (api/knowledge/envelope.make).",
"additionalProperties": true
}
},
"title": "CircuitAnswer",
"required": [
"provenance"
],
"properties": {
"amp": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Amp",
"default": null
},
"bias": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Bias",
"default": null
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error",
"default": null
},
"gated": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Gated",
"default": null
},
"access": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Access",
"default": null
},
"budget": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Budget",
"default": null
},
"stages": {
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "null"
}
],
"title": "Stages",
"default": null
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message",
"default": null
},
"controls": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Controls",
"default": null
},
"verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Verified",
"default": null
},
"versions": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Versions",
"default": null
},
"asked_for": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Asked For",
"default": null
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Available",
"default": null
},
"rectifier": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Rectifier",
"default": null
},
"matched_by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Matched By",
"default": null
},
"part_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Part Count",
"default": null
},
"provenance": {
"$ref": "#/$defs/Provenance"
},
"search_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Search Url",
"default": null
},
"family_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Family Note",
"default": null
},
"pricing_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pricing Url",
"default": null
},
"stage_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Stage Count",
"default": null
},
"tone_stacks": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Tone Stacks",
"default": null
},
"control_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Control Note",
"default": null
},
"version_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Version Note",
"default": null
},
"control_found": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Control Found",
"default": null
},
"control_names": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Control Names",
"default": null
},
"coupling_caps": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Coupling Caps",
"default": null
},
"schematic_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Schematic Url",
"default": null
},
"not_in_catalog": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Not In Catalog",
"default": null
},
"other_versions": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Other Versions",
"default": null
},
"closest_matches": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
{
"type": "null"
}
],
"title": "Closest Matches",
"default": null
},
"negative_feedback": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Negative Feedback",
"default": null
},
"tone_stack_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tone Stack Summary",
"default": null
},
"verification_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Verification Status",
"default": null
}
},
"description": "get_circuit: the Pro circuit projection of a redrawn amp, or its public summary with the go-pro pointer.",
"additionalProperties": true
},
"annotations": {
"title": "Circuit of an amp",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Gridleak is a catalog of real guitar amplifiers, from Fender, Marshall, Mesa/Boogie, Vox, Soldano, Dumble and hundreds of other makers, each built from its schematic. It fits questions about a specific guitar amp: its specs, tubes, history and circuit; how two amps differ; which factory amp model matches it on Quad Cortex, Axe-Fx II, Axe-Fx III, FM3, FM9 or Helix; presets to install on those modelers; the amp on a recording; and modeler fixes. Answers come from Gridleak's verified records and link to the amp's gridleak.app page, so for these questions they are more specific than a general web search. For a signed-in player, 'put the <amp> on my <modeler>' is a Gridleak action too: download_preset with send_to_modeler loads the preset straight into the modeler connected in their open gridleak.app tab, with no editor app and no control of the computer.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.