Skip to main content
Glama

A link to continue in the planner

plan_link
Read-onlyIdempotent

Builds a link to the free Before the Lot planner that opens with the numbers given already filled in, so the person can carry on in the web planner with their trade-in, loan, budget and quotes. Use it after working out numbers in the chat. The plan travels in the link itself, so nothing is stored. Numbers and short labels only; names, phone numbers and emails are refused.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "plan_link"
  }
}

Input Schema

NameRequiredDescriptionDefault
carNoThe car: year, make, model, trim, new or used, and a target price
downNoThe down payment
priceNoThe price: state, tax rate as a decimal, a fair price and the walk line, out the door
tradeNoThe trade-in: whether there is one, its estimated value and the loan payoff on it
budgetNoThe budget: the most per month and the loan term in months
quotesNoDealers' quotes as line items (their add-ons go in quote_add_ons)
financingNoA loan pre-approval: the lender, the APR in percent, the most it lends and its term
trade_offersNoWritten trade-in offers: who made each, the amount and its last day
quote_add_onsNoThe quotes' add-ons, each with the number of the quote it is on

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • addedInput schema / properties / budget
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The budget: the most per month and the loan term in months",
      +  "properties": {
      +    "maxPayment": {
      +      "maximum": 10000000,
      +      "minimum": 0,
      +      "type": "number"
      +    },
      +    "termMonths": {
      +      "maximum": 120,
      +      "minimum": 1,
      +      "type": "integer"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / car
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The car: year, make, model, trim, new or used, and a target price",
      +  "properties": {
      +    "condition": {
      +      "enum": [
      +        "new",
      +        "used"
      +      ],
      +      "type": "string"
      +    },
      +    "make": {
      +      "description": "Make",
      +      "maxLength": 80,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "model": {
      +      "description": "Model",
      +      "maxLength": 80,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "targetPrice": {
      +      "anyOf": [
      +        {
      +          "maximum": 10000000,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "trim": {
      +      "description": "Trim",
      +      "maxLength": 80,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "year": {
      +      "maximum": 2100,
      +      "minimum": 1980,
      +      "type": "integer"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / down
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The down payment",
      +  "properties": {
      +    "amount": {
      +      "anyOf": [
      +        {
      +          "maximum": 10000000,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / financing
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "A loan pre-approval: the lender, the APR in percent, the most it lends and its term",
      +  "properties": {
      +    "aprPercent": {
      +      "anyOf": [
      +        {
      +          "maximum": 40,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "lender": {
      +      "description": "Lender",
      +      "maxLength": 80,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "maxAmount": {
      +      "anyOf": [
      +        {
      +          "maximum": 10000000,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "termMonths": {
      +      "anyOf": [
      +        {
      +          "maximum": 120,
      +          "minimum": 1,
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
    • removedInput schema / properties / plan
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "The parts of the plan to fill in",
      -  "properties": {
      -    "budget": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "maxPayment": {
      -          "maximum": 10000000,
      -          "minimum": 0,
      -          "type": "number"
      -        },
      -        "termMonths": {
      -          "maximum": 120,
      -          "minimum": 1,
      -          "type": "integer"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "car": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "condition": {
      -          "enum": [
      -            "new",
      -            "used"
      -          ],
      -          "type": "string"
      -        },
      -        "make": {
      -          "description": "Make",
      -          "maxLength": 80,
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "model": {
      -          "description": "Model",
      -          "maxLength": 80,
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "targetPrice": {
      -          "anyOf": [
      -            {
      -              "maximum": 10000000,
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "trim": {
      -          "description": "Trim",
      -          "maxLength": 80,
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "year": {
      -          "maximum": 2100,
      -          "minimum": 1980,
      -          "type": "integer"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "down": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "amount": {
      -          "anyOf": [
      -            {
      -              "maximum": 10000000,
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "financing": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "aprPercent": {
      -          "anyOf": [
      -            {
      -              "maximum": 40,
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "lender": {
      -          "description": "Lender",
      -          "maxLength": 80,
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "maxAmount": {
      -          "anyOf": [
      -            {
      -              "maximum": 10000000,
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "termMonths": {
      -          "anyOf": [
      -            {
      -              "maximum": 120,
      -              "minimum": 1,
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "price": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "fairPrice": {
      -          "anyOf": [
      -            {
      -              "maximum": 10000000,
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "quotes": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "addOns": {
      -                "items": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "amount": {
      -                      "maximum": 10000000,
      -                      "minimum": 0,
      -                      "type": "number"
      -                    },
      -                    "name": {
      -                      "description": "Add-on",
      -                      "maxLength": 80,
      -                      "minLength": 1,
      -                      "type": "string"
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "maxItems": 20,
      -                "type": "array"
      -              },
      -              "dealer": {
      -                "description": "Dealer",
      -                "maxLength": 80,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "docFee": {
      -                "maximum": 10000000,
      -                "minimum": 0,
      -                "type": "number"
      -              },
      -              "otherFees": {
      -                "maximum": 10000000,
      -                "minimum": 0,
      -                "type": "number"
      -              },
      -              "rebates": {
      -                "maximum": 10000000,
      -                "minimum": 0,
      -                "type": "number"
      -              },
      -              "receivedOn": {
      -                "anyOf": [
      -                  {
      -                    "maxLength": 40,
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "salesTax": {
      -                "maximum": 10000000,
      -                "minimum": 0,
      -                "type": "number"
      -              },
      -              "titleReg": {
      -                "maximum": 10000000,
      -                "minimum": 0,
      -                "type": "number"
      -              },
      -              "vehiclePrice": {
      -                "maximum": 10000000,
      -                "minimum": 0,
      -                "type": "number"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "maxItems": 10,
      -          "type": "array"
      -        },
      -        "state": {
      -          "pattern": "^[A-Za-z]{2}$",
      -          "type": "string"
      -        },
      -        "taxRate": {
      -          "maximum": 0.2,
      -          "minimum": 0,
      -          "type": "number"
      -        },
      -        "walkLine": {
      -          "anyOf": [
      -            {
      -              "maximum": 10000000,
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "trade": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "estimate": {
      -          "anyOf": [
      -            {
      -              "maximum": 10000000,
      -              "minimum": 0,
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "hasTrade": {
      -          "type": [
      -            "boolean",
      -            "null"
      -          ]
      -        },
      -        "offers": {
      -          "items": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "amount": {
      -                "maximum": 10000000,
      -                "minimum": 0,
      -                "type": "number"
      -              },
      -              "expires": {
      -                "anyOf": [
      -                  {
      -                    "maxLength": 40,
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "source": {
      -                "description": "Where the offer came from",
      -                "maxLength": 80,
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "type": "object"
      -          },
      -          "maxItems": 10,
      -          "type": "array"
      -        },
      -        "payoff": {
      -          "maximum": 10000000,
      -          "minimum": 0,
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / price
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The price: state, tax rate as a decimal, a fair price and the walk line, out the door",
      +  "properties": {
      +    "fairPrice": {
      +      "anyOf": [
      +        {
      +          "maximum": 10000000,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "state": {
      +      "pattern": "^[A-Za-z]{2}$",
      +      "type": "string"
      +    },
      +    "taxRate": {
      +      "maximum": 0.2,
      +      "minimum": 0,
      +      "type": "number"
      +    },
      +    "walkLine": {
      +      "anyOf": [
      +        {
      +          "maximum": 10000000,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / quote_add_ons
      Added value: +{
      +  "description": "The quotes' add-ons, each with the number of the quote it is on",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "amount": {
      +        "maximum": 10000000,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "name": {
      +        "description": "Add-on",
      +        "maxLength": 80,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "quote": {
      +        "description": "Which quote it is on: 1 for the first in quotes",
      +        "maximum": 10,
      +        "minimum": 1,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "quote"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 200,
      +  "type": "array"
      +}
    • addedInput schema / properties / quotes
      Added value: +{
      +  "description": "Dealers' quotes as line items (their add-ons go in quote_add_ons)",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "dealer": {
      +        "description": "Dealer",
      +        "maxLength": 80,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "docFee": {
      +        "maximum": 10000000,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "otherFees": {
      +        "maximum": 10000000,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "rebates": {
      +        "maximum": 10000000,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "receivedOn": {
      +        "description": "When it came",
      +        "maxLength": 40,
      +        "type": "string"
      +      },
      +      "salesTax": {
      +        "maximum": 10000000,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "titleReg": {
      +        "maximum": 10000000,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "vehiclePrice": {
      +        "maximum": 10000000,
      +        "minimum": 0,
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "maxItems": 10,
      +  "type": "array"
      +}
    • addedInput schema / properties / trade
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The trade-in: whether there is one, its estimated value and the loan payoff on it",
      +  "properties": {
      +    "estimate": {
      +      "anyOf": [
      +        {
      +          "maximum": 10000000,
      +          "minimum": 0,
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "hasTrade": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "payoff": {
      +      "maximum": 10000000,
      +      "minimum": 0,
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / trade_offers
      Added value: +{
      +  "description": "Written trade-in offers: who made each, the amount and its last day",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "amount": {
      +        "maximum": 10000000,
      +        "minimum": 0,
      +        "type": "number"
      +      },
      +      "expires": {
      +        "description": "Its last day",
      +        "maxLength": 40,
      +        "type": "string"
      +      },
      +      "source": {
      +        "description": "Where the offer came from",
      +        "maxLength": 80,
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "maxItems": 10,
      +  "type": "array"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "plan"
      -]
  2. First observed

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish read-only, idempotent, non-destructive, closed-world behavior. The description adds meaningful context beyond that: the plan travels in the link itself, nothing is stored, and names, phone numbers, and emails are refused. It does not cover link expiry, length limits, or error behavior, so it stops short of full transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is four tight sentences and front-loads the core action before explaining usage, storage behavior, and input restrictions. Every sentence carries useful information with no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex tool with nine nested optional parameter groups, the description covers the essential purpose, when to use it, privacy/storage behavior, and input restrictions. It does not mention link expiry or how partial inputs are handled, but the rich schema fills in most field-level detail.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents the nine nested parameter groups. The description still adds value by stating that only numbers and short labels are accepted and that PII such as names, phone numbers, and emails is refused, which is not encoded in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: it 'Builds a link' to the Before the Lot planner with supplied numbers pre-filled. That clearly distinguishes it from sibling calculation tools such as out_the_door or loan_payment, which work out numbers rather than package them into a planner link.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a clear usage condition: 'Use it after working out numbers in the chat.' It does not explicitly name alternatives or state when not to use it, but the prerequisite and the handoff-to-web-planner context are sufficient for correct selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources