Server definition
- Hash
- sha256:2335699fce8326cc7e216b3ca42674e963c9529c1be432c14873c72ed6b2aab2
- What it is
- What a remote MCP server returned when asked what it offers: 9 tools
The blob, as servednamed by its sha256
{
"instructions": "LiveVariant runs A/B tests with multi-armed bandits, so traffic shifts toward the winner while the test runs instead of waiting for a frozen split to reach significance.\n\nCreating a test needs no account. A test IS its config, encoded into its own URLs, and its identity is a hash of that config, so editing a variant produces a different test with its own empty history. build_test returns a stats secret exactly once; without it a test's results can never be read by anyone.\n\nThree shapes, one model: email/image tests (image variants, serve URL in an <img>), page redirect tests (url variants, one link that 302s), and website tests (text/html variants served on-page via the tag or SDK with the ENCODED config). Multi-element tests use slots; one model optimizes the combination.\n\nTypical flow: variant_brief to learn the constraints, then PLAN with the human before building: propose which elements (slots) and variants to test, defaulting to assets they already have and offering to generate creative rather than silently doing so, and show the full proposed test for iteration. Only then build_test for the URLs (an edit after building is a NEW test with an empty history, so iterate on the plan). Optionally generate_priors to warm-start from what you expect, then get_stats to read results. Trust get_stats's win probabilities over comparing conversion rates by eye.\n\nMissing image variants are not a blocker: author HTML/SVG, render to fixed-size PNGs (browser screenshot or your image tool), and upload_image each; all variants of one element must share exact dimensions.\n\nTo save a test into a human's account, ask for the publishable key (pk_...) for an organization they administer and pass it to build_test (registers at creation), or hand them build_test's manage URL (one signed-in click); never collect credentials. When returning a newly built test, include the manage URL plus the ready-to-paste links for the channel (per-slot for multi-slot tests, merge tag in id=, auto=0 for email). When the human sends through an ESP or newsletter template, also hand over build_test's emailTemplate spelling unprompted: wired in once, every future campaign mints its own fresh test with no build step, and the shared kh reads them all. Be explicit that a two-slot template carries three links: one serve link per slot in its own <img> (slot=hero, slot=cta), plus the click link that records the win and redirects.\n\nRelay destination warnings: an unverified redirect destination shows visitors a continue screen (get_test_status reports this; so does build_test). The fix is verifying the domain under Settings (DNS TXT, well-known file, or the tag with their publishable key live on the site); the tag also auto-tracks conversions from GA events and enables on-page tests, so suggest it when the user owns the site.\n\nThese instructions are the short version. Before building your first test, read the full skill: it has the recipes (email pitfalls, the plain-URL grammar, multi-slot tests, priors, generating image variants) that these tools assume you know. Read it via this server's `skill` resource (resources/read), or fetch https://livevariant.com/skills/livevariant/SKILL.md. Agents with a skills directory can install it permanently with `npx skills add livevariant/livevariant`. The whole service is open source (AGPL): to read the source, start with the README at https://github.com/livevariant/livevariant.",
"tools": [
{
"description": "Creates a LiveVariant test and returns every URL needed to run it, plus a freshly generated stats secret.\n\nPass `variants` to test one element, or `slots` to test several at once (hero image AND call-to-action, say). With slots the test optimizes the COMBINATION: one model learns how the elements interact, which two separate tests structurally cannot see. There is no algorithm to pick either way; every test runs the same joint model, sized from its shape.\n\nBy default, nothing is registered anywhere: the config IS the test, encoded into the URLs, and the test's identity is a hash of it. Pass `publishableKey` on an account-enabled deployment to also register the new test to that key's organization, so it appears under My tests; the config and URLs are still the test, and registration failure is returned as a warning rather than failing the build. Editing a variant later produces a DIFFERENT test with its own empty history, which is usually what you want per campaign but is worth saying out loud to whoever you are building this for.\n\nThe stats secret is returned once and never again. Only its hash goes into the config, so nobody, including this service, can recover it. Give it to the person who will read the results.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"context": {
"description": "Dimensions to learn a separate winner for.",
"items": {
"properties": {
"from": {
"description": "Fill this dimension from a signal the server derives, so the caller never sends it. Network signals (country, device, …) are guessed from the connection and are suppressed for proxied email fetches; utm_* are read off the link and survive a proxy intact, which makes them the reliable choice for email.",
"enum": [
"country",
"continent",
"region",
"city",
"timezone",
"device",
"language",
"organization",
"utm_source",
"utm_medium",
"utm_campaign",
"utm_content",
"utm_term"
],
"type": "string"
},
"key": {
"description": "Dimension name, e.g. country. Becomes ?c_<key>= on serve URLs.",
"minLength": 1,
"type": "string"
},
"values": {
"description": "Allowed values, when they are enumerable. Anything else is rejected at serving time, which is what stops a crafted URL inventing buckets. It also makes the results readable: bucket keys are one-way hashes, and a declared list is what lets stats recover \"country=nl\" from one. Worth passing even for a `from` dimension, and worth getting right the first time, since `ctx` is inside the test identity and adding values later starts a new test.",
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 2,
"type": "array"
}
},
"required": [
"key"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"name": {
"description": "A label for your own reference, and the one field worth spending a merge tag on in a recurring ESP template: it is part of the test's identity, so n={{campaign_name}} mints a separate, separately readable test per campaign, and the name is what list_tests searches.",
"minLength": 1,
"type": "string"
},
"publishableKey": {
"description": "Registers the new test to the organization identified by a publishable key the user provides for an organization they administer. Result access stays tied to this test's stats secret. Only works on account-enabled deployments; elsewhere a warning says so and the test still works.",
"pattern": "^pk_[a-z0-9]{24}$",
"type": "string"
},
"redirectUrl": {
"description": "Where clicks land when a variant does not say.",
"format": "uri",
"type": "string"
},
"region": {
"description": "Where the test's state lives. A placement hint (wnam, enam, sam, weur, eeur, apac, oc, afr, me) or \"eu\" for the EU jurisdiction (state guaranteed created and kept inside the EU). Defaults to the creator's own region when the host can tell; without any, state is born wherever the FIRST request comes from, which in email is routinely a mail provider's US datacenter.",
"enum": [
"wnam",
"enam",
"sam",
"weur",
"eeur",
"apac",
"oc",
"afr",
"me",
"eu"
],
"type": "string"
},
"slotRedirects": {
"additionalProperties": {
"format": "uri",
"type": "string"
},
"description": "Where clicks on ONE element land, when elements point at different pages (a hero leading to the campaign landing page, a CTA below it to pricing). Keyed like `slots`. Falls back to `redirectUrl`; a variant's own redirectUrl still wins over both. Setting any of these means every click link must name its slot, which slotLinks does for you.",
"propertyNames": {
"pattern": "^[a-z][a-z0-9_-]{0,31}$",
"type": "string"
},
"type": "object"
},
"slots": {
"additionalProperties": {
"items": {
"properties": {
"html": {
"description": "Inline HTML, served by the SDK.",
"type": "string"
},
"image": {
"description": "Image URL, for email variants.",
"format": "uri",
"type": "string"
},
"markdown": {
"description": "Inline markdown, served by the SDK.",
"type": "string"
},
"name": {
"description": "Shown in stats and in the utm stamp. Defaults to v1, v2, …",
"minLength": 1,
"type": "string"
},
"redirectUrl": {
"description": "Where a click on this variant lands, if it differs per variant.",
"format": "uri",
"type": "string"
},
"text": {
"description": "Inline text, served by the SDK.",
"type": "string"
},
"url": {
"description": "Destination for redirect serving.",
"format": "uri",
"type": "string"
}
},
"type": "object"
},
"maxItems": 64,
"minItems": 1,
"type": "array"
},
"description": "Multi-element test: variants per element, keyed by a short name like \"hero\" or \"cta\". The test serves and learns combinations.",
"propertyNames": {
"pattern": "^[a-z][a-z0-9_-]{0,31}$",
"type": "string"
},
"type": "object"
},
"variantParam": {
"description": "Stamp the served combination into this parameter on redirect, e.g. \"utm_content\", so the test shows up in the customer's own analytics.",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"variants": {
"description": "Single-element test: two or more variants. The first is the control.",
"items": {
"properties": {
"html": {
"description": "Inline HTML, served by the SDK.",
"type": "string"
},
"image": {
"description": "Image URL, for email variants.",
"format": "uri",
"type": "string"
},
"markdown": {
"description": "Inline markdown, served by the SDK.",
"type": "string"
},
"name": {
"description": "Shown in stats and in the utm stamp. Defaults to v1, v2, …",
"minLength": 1,
"type": "string"
},
"redirectUrl": {
"description": "Where a click on this variant lands, if it differs per variant.",
"format": "uri",
"type": "string"
},
"text": {
"description": "Inline text, served by the SDK.",
"type": "string"
},
"url": {
"description": "Destination for redirect serving.",
"format": "uri",
"type": "string"
}
},
"type": "object"
},
"maxItems": 64,
"minItems": 2,
"type": "array"
}
},
"type": "object"
},
"name": "build_test",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"combinations": {
"description": "How many distinct combinations the test chooses between.",
"type": "number"
},
"config": {
"description": "The encoded config: this is the test.",
"type": "string"
},
"destinations": {
"description": "Redirect destinations and whether each is a verified domain. Unverified means visitors see a 'Redirecting you to…' continue screen before landing; relay the verification warning to the user when present.",
"items": {
"additionalProperties": false,
"properties": {
"host": {
"type": "string"
},
"verified": {
"type": "boolean"
}
},
"required": [
"host",
"verified"
],
"type": "object"
},
"type": "array"
},
"emailTemplate": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"imageSrc": {
"type": "string"
},
"linkHref": {
"type": "string"
}
},
"required": [
"imageSrc",
"linkHref"
],
"type": "object"
},
"description": "Query-parameter spelling per slot for an ESP template: wire it once, then campaign managers fill only the merge fields. All links share one identical config string (names, ctx dims, kh and the landing r=/sr= included, so serve and click stay ONE test); image links add &slot= per element. The click link needs no slot unless the test sets slotRedirects, in which case each element's click link carries its own. Absent when a variant has inline content or its own redirectUrl, which the parameter form cannot express.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Where the test's state will live; null means first-request placement."
},
"registeredTo": {
"description": "The organization the test was registered to, when a publishableKey was given and accepted.",
"type": "string"
},
"slotLinks": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"click": {
"type": "string"
},
"serve": {
"type": "string"
}
},
"required": [
"serve",
"click"
],
"type": "object"
},
"description": "Multi-slot tests only: the serve/click URL per element. The bare urls.serve returns 400 for these tests, because a serve must say which element it renders. The bare urls.click works when the destination is uniform (a config redirectUrl or ?to=); per-slot clicks matter as soon as an element carries its own destination, via slotRedirects or a variant redirectUrl.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"slots": {
"description": "Canonical slot order with variant names, as stats reports them.",
"items": {
"additionalProperties": false,
"properties": {
"slot": {
"type": "string"
},
"variants": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"slot",
"variants"
],
"type": "object"
},
"type": "array"
},
"statsSecret": {
"description": "Shown once. Store it now.",
"type": "string"
},
"testId": {
"type": "string"
},
"urls": {
"additionalProperties": false,
"properties": {
"click": {
"type": "string"
},
"clickNoAutoContext": {
"type": "string"
},
"manage": {
"description": "Opening this URL shows live results, and signed-in users can click 'Add to my account' to claim the test into their dashboard. It contains the stats secret in its #fragment, so share it only with people authorized to see results.",
"type": "string"
},
"pixel": {
"type": "string"
},
"serve": {
"type": "string"
},
"serveNoAutoContext": {
"type": "string"
}
},
"required": [
"serve",
"click",
"pixel",
"manage",
"serveNoAutoContext",
"clickNoAutoContext"
],
"type": "object"
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"testId",
"config",
"statsSecret",
"slots",
"combinations",
"region",
"urls",
"warnings"
],
"type": "object"
}
},
{
"description": "Takes YOUR estimate of how each variant will perform and converts it into the prior the model starts from, so a test does not spend its first visitors rediscovering what you already suspect.\n\nYou supply the guess; this does the arithmetic and the capping. That capping is the point: a prior is expressed as pseudo-observations, and it is deliberately held weak enough that real data overrides it quickly. The response says exactly how many real visitors per variant it takes to wash your guess out, so you can judge whether you have been too confident. Being wrong here costs a little early traffic, not the test.\n\nPriors are outside the identity hash, so the test keeps its id, its URLs and any history it already has.\n\nPass `when` to make the belief hold for ONE segment only (\"image B is the one for the blue segment\"). Without it the belief is about every visitor, which is a different and much stronger claim.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"oneOf": [
{
"required": [
"test"
]
},
{
"required": [
"config"
]
}
],
"properties": {
"beliefs": {
"items": {
"properties": {
"rate": {
"description": "Your estimate of its conversion rate, e.g. 0.04 for 4%.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"slot": {
"description": "Which slot the variant belongs to. Optional for single-slot tests.",
"type": "string"
},
"variant": {
"anyOf": [
{
"type": "string"
},
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
],
"description": "Variant name or index within its slot."
}
},
"required": [
"variant",
"rate"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"confidence": {
"anyOf": [
{
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
{
"exclusiveMinimum": 0,
"type": "number"
}
],
"default": "medium",
"description": "How much your guess is worth in observations. low=5, medium=15, high=30, or give a number directly. Higher means the test trusts you for longer before the data takes over."
},
"config": {
"description": "Alias for `test`: the same value under the name build_test returns it as (`config`). Pass one or the other.",
"minLength": 1,
"type": "string"
},
"test": {
"description": "The test: an encoded config, or any LiveVariant URL containing one (serve, click, pixel, manage), or a query-parameter serve URL. Paste whatever you have.",
"minLength": 1,
"type": "string"
},
"when": {
"additionalProperties": {
"type": "string"
},
"description": "Context this belief is limited to, as dimension key to value (e.g. {\"color\": \"blauw\"}). The keys must be dimensions the test declares. Omit it for a belief about every visitor.",
"propertyNames": {
"type": "string"
},
"type": "object"
}
},
"required": [
"beliefs"
],
"type": "object"
},
"name": "generate_priors",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"config": {
"type": "string"
},
"manageUrl": {
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"priors": {
"items": {
"additionalProperties": false,
"properties": {
"mean": {
"type": "number"
},
"slot": {
"type": "string"
},
"strength": {
"type": "number"
},
"variant": {
"type": "string"
}
},
"required": [
"slot",
"variant",
"mean",
"strength"
],
"type": "object"
},
"type": "array"
},
"testId": {
"type": "string"
},
"washesOutAfter": {
"description": "Roughly this many real visitors per variant and your guess stops mattering.",
"type": "number"
}
},
"required": [
"testId",
"config",
"manageUrl",
"priors",
"washesOutAfter",
"notes"
],
"type": "object"
}
},
{
"description": "Fetches a test's results and works out what they mean.\n\nAlongside the raw counts it returns the probability that each combination is genuinely best and the expected cost of stopping now and keeping the leader. Use those rather than comparing conversion rates by eye: a variant ahead 2/10 to 1/10 looks twice as good and is very close to a coin flip, and that mistake is the single most common way an A/B test gets called wrong.\n\nMulti-slot tests also report per-slot marginals: how each variant did across every combination it appeared in.\n\nNeeds the stats secret. If you have the manage URL, its #fragment IS the secret and it will be used automatically.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"oneOf": [
{
"required": [
"test"
]
},
{
"required": [
"config"
]
}
],
"properties": {
"config": {
"description": "Alias for `test`: the same value under the name build_test returns it as (`config`). Pass one or the other.",
"minLength": 1,
"type": "string"
},
"statsSecret": {
"description": "Omit when passing a manage URL that carries it in the fragment.",
"type": "string"
},
"test": {
"description": "The test: an encoded config, or any LiveVariant URL containing one (serve, click, pixel, manage), or a query-parameter serve URL. Paste whatever you have.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "get_stats",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bySignal": {
"additionalProperties": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"conversions": {
"type": "number"
},
"pulls": {
"type": "number"
}
},
"required": [
"pulls",
"conversions"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"combinations": {
"items": {
"additionalProperties": false,
"properties": {
"choice": {
"items": {
"type": "string"
},
"type": "array"
},
"conversionRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"conversions": {
"type": "number"
},
"probabilityBest": {
"type": "number"
},
"pulls": {
"type": "number"
}
},
"required": [
"choice",
"pulls",
"conversions",
"conversionRate",
"probabilityBest"
],
"type": "object"
},
"type": "array"
},
"contextBuckets": {
"type": "number"
},
"decision": {
"additionalProperties": false,
"properties": {
"advice": {
"type": "string"
},
"canStop": {
"type": "boolean"
},
"expectedLossIfStoppingNow": {
"type": "number"
},
"leader": {
"type": "string"
},
"relativeLoss": {
"type": "number"
}
},
"required": [
"leader",
"canStop",
"expectedLossIfStoppingNow",
"relativeLoss",
"advice"
],
"type": "object"
},
"excluded": {
"additionalProperties": false,
"properties": {
"bySource": {
"type": "number"
},
"byWindow": {
"type": "number"
},
"total": {
"type": "number"
}
},
"required": [
"total",
"bySource",
"byWindow"
],
"type": "object"
},
"slots": {
"additionalProperties": {
"items": {
"additionalProperties": false,
"properties": {
"conversionRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"conversions": {
"type": "number"
},
"name": {
"type": "string"
},
"pulls": {
"type": "number"
}
},
"required": [
"name",
"pulls",
"conversions",
"conversionRate"
],
"type": "object"
},
"type": "array"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"testId": {
"type": "string"
},
"totalAssignments": {
"type": "number"
}
},
"required": [
"testId",
"totalAssignments",
"combinations",
"slots",
"decision",
"contextBuckets",
"bySignal",
"excluded"
],
"type": "object"
}
},
{
"description": "Reports what the deployment's registry knows about a test: whether it is claimed into an account (and by which organization), and whether each redirect destination is a verified domain.\n\nUnverified destinations work, but visitors see a 'Redirecting you to…' continue screen first. When you see verified: false, tell the user to verify the domain under Settings on the dashboard; the three ways are a DNS TXT record, serving the well-known file, or having the SDK tag with their publishable key live in the site's source. If the test is unclaimed, remind them the manage URL claims it in one click when opened signed in.\n\nRequires the test's stats secret, the same as get_stats. A manage URL's #fragment is used automatically.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"oneOf": [
{
"required": [
"test"
]
},
{
"required": [
"config"
]
}
],
"properties": {
"config": {
"description": "Alias for `test`: the same value under the name build_test returns it as (`config`). Pass one or the other.",
"minLength": 1,
"type": "string"
},
"statsSecret": {
"description": "Omit when passing a manage URL that carries it in the fragment.",
"type": "string"
},
"test": {
"description": "The test: an encoded config, or any LiveVariant URL containing one (serve, click, pixel, manage), or a query-parameter serve URL. Paste whatever you have.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "get_test_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"claimed": {
"description": "Whether the test is registered to an organization.",
"type": "boolean"
},
"destinations": {
"description": "Every host this test can redirect a visitor to. verified: false means the continue screen shows before landing there.",
"items": {
"additionalProperties": false,
"properties": {
"host": {
"type": "string"
},
"verified": {
"type": "boolean"
}
},
"required": [
"host",
"verified"
],
"type": "object"
},
"type": "array"
},
"org": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The claiming organization's name; null when unclaimed."
},
"testId": {
"type": "string"
}
},
"required": [
"testId",
"claimed",
"org",
"destinations"
],
"type": "object"
}
},
{
"description": "Decodes a test and describes it: slots, variants, context, and whether it can be served by redirect. Also lints it for the mistakes that only show up once a campaign is out, such as an email test whose context comes from geo (which a mail proxy answers about itself).\n\nUse this before sending anything, and to answer 'what is this link?'.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"oneOf": [
{
"required": [
"test"
]
},
{
"required": [
"config"
]
}
],
"properties": {
"config": {
"description": "Alias for `test`: the same value under the name build_test returns it as (`config`). Pass one or the other.",
"minLength": 1,
"type": "string"
},
"test": {
"description": "The test: an encoded config, or any LiveVariant URL containing one (serve, click, pixel, manage), or a query-parameter serve URL. Paste whatever you have.",
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "inspect_test",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"combinations": {
"type": "number"
},
"context": {
"items": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"key": {
"type": "string"
},
"values": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"key"
],
"type": "object"
},
"type": "array"
},
"findings": {
"items": {
"additionalProperties": false,
"properties": {
"level": {
"enum": [
"error",
"warning",
"note"
],
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"level",
"message"
],
"type": "object"
},
"type": "array"
},
"name": {
"type": "string"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"resultsReadable": {
"description": "False when the config has no stats key, which is permanent.",
"type": "boolean"
},
"slots": {
"items": {
"additionalProperties": false,
"properties": {
"slot": {
"type": "string"
},
"variants": {
"items": {
"additionalProperties": false,
"properties": {
"formats": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"type": "string"
},
"servesByRedirect": {
"type": "boolean"
}
},
"required": [
"name",
"formats",
"servesByRedirect"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"slot",
"variants"
],
"type": "object"
},
"type": "array"
},
"testId": {
"type": "string"
}
},
"required": [
"testId",
"slots",
"combinations",
"region",
"context",
"resultsReadable",
"findings"
],
"type": "object"
}
},
{
"description": "Lists tests registered to the signed-in account, newest first, with cursor pagination and an optional case-insensitive name filter. Only exists on deployments with accounts, and only answers for an identified caller: unlike every other tool, WHOSE tests these are cannot be expressed as an argument. Each entry carries the encoded config, which inspect_test and get_stats accept directly.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor": {
"description": "Opaque cursor from a previous page's nextCursor",
"type": "string"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Case-insensitive substring filter on the test name",
"maxLength": 200,
"type": "string"
}
},
"type": "object"
},
"name": "list_tests",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"nextCursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"tests": {
"items": {
"additionalProperties": false,
"properties": {
"addedAt": {
"type": "number"
},
"encoded": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"testId": {
"type": "string"
}
},
"required": [
"testId",
"name",
"encoded",
"region",
"addedAt"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"tests",
"nextCursor"
],
"type": "object"
}
},
{
"description": "Registers a test you built earlier to the organization a publishable key belongs to, so it shows under My tests and its stats are readable from the dashboard without the secret.\n\nUse this only when the user provides both the test's stats secret and a publishable key for an organization they administer. The stats secret must match the hash inside the config, and the publishable key identifies the organization to register into. Prefer passing publishableKey to build_test directly: it registers at creation in one step. Keyless tests cannot be registered this way (nothing to prove with); they register through the tag on a verified domain. The organization can remove a listing from its dashboard (the test itself keeps serving).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"config": {
"description": "The encoded test config (from build_test or any test URL).",
"minLength": 1,
"type": "string"
},
"publishableKey": {
"description": "A publishable key for the target organization, provided by a user authorized to register tests there.",
"pattern": "^pk_[a-z0-9]{24}$",
"type": "string"
},
"statsSecret": {
"description": "The test's stats secret, exactly as build_test returned it.",
"minLength": 1,
"type": "string"
}
},
"required": [
"config",
"statsSecret",
"publishableKey"
],
"type": "object"
},
"name": "register_test",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"org": {
"description": "The organization that now owns the test.",
"type": "string"
},
"registered": {
"const": true,
"type": "boolean"
},
"testId": {
"type": "string"
}
},
"required": [
"registered",
"org",
"testId"
],
"type": "object"
}
},
{
"description": "Uploads an image to the deployment's asset store and returns its URL, for use as a variant's `image` (email tests) or `url`.\n\nThe returned URL is deliberately not fetchable on its own: assets are only served with a short-lived signature that the serve endpoints mint per request, so uploading here does not create free static hosting. Use `previewUrl` (valid for an hour) to check what was stored.\n\nStorage is content-addressed: the id is the sha256 of the bytes, so uploading the same image twice is harmless and returns the same URL. Raster images only; SVG is refused because it can carry scripts. Not every deployment enables asset hosting, and this tool says so plainly when yours does not.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"contentType": {
"description": "The image's actual type; the server stores and serves it as this.",
"enum": [
"image/png",
"image/jpeg",
"image/gif",
"image/webp",
"image/avif"
],
"type": "string"
},
"data": {
"description": "The image bytes, base64-encoded (plain base64, not a data: URL).",
"maxLength": 8000000,
"minLength": 1,
"type": "string"
}
},
"required": [
"data",
"contentType"
],
"type": "object"
},
"name": "upload_image",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assetId": {
"description": "sha256 of the bytes; the id inside the URL.",
"type": "string"
},
"contentType": {
"type": "string"
},
"previewUrl": {
"description": "Signed for one hour, to verify the upload.",
"type": "string"
},
"size": {
"type": "number"
},
"url": {
"description": "Use this as the variant's image/url. 403s without a signature, by design.",
"type": "string"
}
},
"required": [
"assetId",
"url",
"previewUrl",
"size",
"contentType"
],
"type": "object"
}
},
{
"description": "Returns the constraints to write or generate test variants against, for email or web, plus the rules that decide whether a test can be read at all once it runs.\n\nThe one that matters most: one idea per slot. To vary two elements, give the test two slots and let it learn the combination, rather than bundling both changes into one variant and never learning which half worked. Ask for this before drafting variants, then produce them yourself against what it returns.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"audience": {
"description": "Who sees it, if that shapes the copy.",
"type": "string"
},
"channel": {
"enum": [
"email",
"web"
],
"type": "string"
},
"count": {
"default": 2,
"maximum": 10,
"minimum": 2,
"type": "integer"
},
"format": {
"description": "What each variant will be.",
"enum": [
"image",
"text",
"html",
"url"
],
"type": "string"
},
"goal": {
"description": "What the test should improve, e.g. 'more demo bookings'.",
"minLength": 1,
"type": "string"
}
},
"required": [
"goal",
"channel",
"format"
],
"type": "object"
},
"name": "variant_brief",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"goal": {
"type": "string"
},
"hosting": {
"type": "string"
},
"nextStep": {
"type": "string"
},
"rules": {
"items": {
"type": "string"
},
"type": "array"
},
"specs": {
"items": {
"type": "string"
},
"type": "array"
},
"variantCount": {
"type": "number"
}
},
"required": [
"goal",
"variantCount",
"specs",
"rules",
"hosting",
"nextStep"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:2335699fce8326cc7e216b3ca42674e963c9529c1be432c14873c72ed6b2aab2 | sha256sum