{"openapi":"3.1.0","info":{"title":"Foundations Elements","version":"1.0.0","description":"UI encyclopedia for agents. Kind lists are 0.01 USDC; specs are 0.02 USDC on Base. Waitlist: https://tensegrity.company/elements?utm_source=x402&utm_medium=api","x-guidance":"Directory front door: GET /mcp/elements/search (0.02 USDC). GET /mcp/search is an alias. Free intake: GET /mcp/start. Free map: GET /mcp/elements. Kind lists 0.01 USDC; specs 0.02 USDC. Send PAYMENT-SIGNATURE (or X-PAYMENT). Example search: q=funnel-chart. Docs: https://foundations.tensegrity.works/docs","contact":{"name":"Tensegrity Systems LLC","email":"support@tensegrity.company","url":"https://tensegrity.company/elements?utm_source=x402&utm_medium=api"},"license":{"name":"Proprietary. See /terms."}},"x-service-info":{"categories":["data","developer-tools"],"docs":{"apiReference":"https://foundations.tensegrity.works/docs","homepage":"https://tensegrity.company/elements?utm_source=x402&utm_medium=api","llms":"https://foundations.tensegrity.works/llms.txt"}},"servers":[{"url":"https://foundations.tensegrity.works"}],"tags":[{"name":"Discovery","description":"Free maps and docs"},{"name":"Lookups","description":"Paid kind lists and specs"}],"paths":{"/mcp/elements/search":{"get":{"tags":["Lookups"],"summary":"Paid cross-kind search","description":"Directory front door. Unpaid GET returns 402. Paid GET with no query returns the search contract. Paid GET with q or another filter returns at most 5 briefs.","operationId":"searchElements","security":[{"paymentSignature":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Name, slug, or alias substring. Alias: text.","schema":{"type":"string","minLength":1,"maxLength":80},"example":"funnel-chart"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["actions","form","layout","lists","nav","overlay","charts","data-display","media","marketing","text","motion","ai","selection","date-time","analog","tokens","gesture","containers","status","notification","agent-surface","glanceable","alternative-content","telemetry-control","diagrams","maps","shell","chat","agent","generative-ui","playback","visual"]},"example":"charts"},{"name":"complexity","in":"query","required":false,"schema":{"type":"string","enum":["Low","Medium","High"]}},{"name":"atomicType","in":"query","required":false,"schema":{"type":"string","enum":["atom","molecule","organism"]}},{"name":"domain","in":"query","required":false,"schema":{"type":"string"}},{"name":"context","in":"query","required":false,"description":"Industry slug, or repeat / comma-separate.","schema":{"type":"string"}},{"name":"group","in":"query","required":false,"schema":{"type":"string","enum":["complexity","atomicType","kind","domain","context"]}},{"name":"perGroup","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5}}],"responses":{"200":{"description":"Search hits or the empty-query contract","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Search"}}}},"400":{"description":"Invalid filter after payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header (or X-PAYMENT-REQUIRED) or read the JSON body.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 challenge (accepts[], resource, optional waitlist extensions).","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Same challenge as PAYMENT-REQUIRED, for v1 clients.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}}}}},"/mcp/search":{"get":{"tags":["Lookups"],"summary":"Paid cross-kind search (alias)","description":"Working alias of GET /mcp/elements/search. Same 402, query, and grant.","operationId":"searchElementsAlias","security":[{"paymentSignature":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Name, slug, or alias substring. Alias: text.","schema":{"type":"string","minLength":1,"maxLength":80},"example":"funnel-chart"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["actions","form","layout","lists","nav","overlay","charts","data-display","media","marketing","text","motion","ai","selection","date-time","analog","tokens","gesture","containers","status","notification","agent-surface","glanceable","alternative-content","telemetry-control","diagrams","maps","shell","chat","agent","generative-ui","playback","visual"]},"example":"charts"},{"name":"complexity","in":"query","required":false,"schema":{"type":"string","enum":["Low","Medium","High"]}},{"name":"atomicType","in":"query","required":false,"schema":{"type":"string","enum":["atom","molecule","organism"]}},{"name":"domain","in":"query","required":false,"schema":{"type":"string"}},{"name":"context","in":"query","required":false,"description":"Industry slug, or repeat / comma-separate.","schema":{"type":"string"}},{"name":"group","in":"query","required":false,"schema":{"type":"string","enum":["complexity","atomicType","kind","domain","context"]}},{"name":"perGroup","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5}}],"responses":{"200":{"description":"Search hits or the empty-query contract","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Search"}}}},"400":{"description":"Invalid filter after payment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header (or X-PAYMENT-REQUIRED) or read the JSON body.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 challenge (accepts[], resource, optional waitlist extensions).","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Same challenge as PAYMENT-REQUIRED, for v1 clients.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}}}}},"/mcp/start":{"get":{"tags":["Discovery"],"summary":"Free start briefing","operationId":"startElements","security":[],"parameters":[],"responses":{"200":{"description":"Kinds, example slugs, prices, and next hops","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Start"}}}}}}},"/mcp/elements":{"get":{"tags":["Discovery"],"summary":"Free kinds table","operationId":"listKinds","security":[],"parameters":[],"responses":{"200":{"description":"33 kinds with counts and paid list paths","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Kinds"},"example":{"kinds":[{"kind":"charts","count":1,"path":"/mcp/elements/charts"}]}}}}}}},"/mcp/elements/{kind}":{"get":{"tags":["Lookups"],"summary":"Paid kind list","operationId":"listKind","security":[{"paymentSignature":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"kind","in":"path","required":true,"description":"One of the 33 kind slugs from GET /mcp/elements.","schema":{"type":"string","enum":["actions","form","layout","lists","nav","overlay","charts","data-display","media","marketing","text","motion","ai","selection","date-time","analog","tokens","gesture","containers","status","notification","agent-surface","glanceable","alternative-content","telemetry-control","diagrams","maps","shell","chat","agent","generative-ui","playback","visual"]},"example":"charts"}],"responses":{"200":{"description":"Slugs and entries for one kind","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KindList"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header (or X-PAYMENT-REQUIRED) or read the JSON body.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 challenge (accepts[], resource, optional waitlist extensions).","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Same challenge as PAYMENT-REQUIRED, for v1 clients.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown kind or slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mcp/elements/{kind}/{slug}":{"get":{"tags":["Lookups"],"summary":"Paid spec","operationId":"getElementSpec","security":[{"paymentSignature":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"kind","in":"path","required":true,"description":"One of the 33 kind slugs from GET /mcp/elements.","schema":{"type":"string","enum":["actions","form","layout","lists","nav","overlay","charts","data-display","media","marketing","text","motion","ai","selection","date-time","analog","tokens","gesture","containers","status","notification","agent-surface","glanceable","alternative-content","telemetry-control","diagrams","maps","shell","chat","agent","generative-ui","playback","visual"]},"example":"charts"},{"name":"slug","in":"path","required":true,"description":"Element slug from a paid kind list.","schema":{"type":"string","minLength":1},"example":"funnel-chart"}],"responses":{"200":{"description":"Glossary spec body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Spec"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header (or X-PAYMENT-REQUIRED) or read the JSON body.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 challenge (accepts[], resource, optional waitlist extensions).","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Same challenge as PAYMENT-REQUIRED, for v1 clients.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown kind or slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/glossary/{slug}":{"get":{"tags":["Lookups"],"summary":"Paid spec by slug","operationId":"getGlossarySpec","security":[{"paymentSignature":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"slug","in":"path","required":true,"description":"Element slug from a paid kind list.","schema":{"type":"string","minLength":1},"example":"funnel-chart"}],"responses":{"200":{"description":"Glossary spec body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Spec"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header (or X-PAYMENT-REQUIRED) or read the JSON body.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 challenge (accepts[], resource, optional waitlist extensions).","schema":{"type":"string"}},"X-PAYMENT-REQUIRED":{"description":"Same challenge as PAYMENT-REQUIRED, for v1 clients.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown kind or slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"parameters":{"kind":{"name":"kind","in":"path","required":true,"description":"One of the 33 kind slugs from GET /mcp/elements.","schema":{"type":"string","enum":["actions","form","layout","lists","nav","overlay","charts","data-display","media","marketing","text","motion","ai","selection","date-time","analog","tokens","gesture","containers","status","notification","agent-surface","glanceable","alternative-content","telemetry-control","diagrams","maps","shell","chat","agent","generative-ui","playback","visual"]},"example":"charts"},"slug":{"name":"slug","in":"path","required":true,"description":"Element slug from a paid kind list.","schema":{"type":"string","minLength":1},"example":"funnel-chart"}},"securitySchemes":{"paymentSignature":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 payment payload matching accepts[] from the 402 challenge. X-PAYMENT is an alias."}},"headers":{"PAYMENT-SIGNATURE":{"description":"x402 v2 payment payload (JSON or base64 JSON) matching accepts[] from PAYMENT-REQUIRED. X-PAYMENT is an alias.","schema":{"type":"string"}},"X-PAYMENT":{"description":"Alias of PAYMENT-SIGNATURE for v1 clients.","schema":{"type":"string"}}},"schemas":{"Kinds":{"type":"object","properties":{"kinds":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"count":{"type":"integer"},"path":{"type":"string"}},"required":["kind","count","path"]}}},"required":["kinds"]},"Search":{"type":"object","properties":{"q":{"type":["string","null"]},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object"}},"hint":{"type":"string"},"examples":{"type":"array","items":{"type":"string"}},"filters":{"type":"object"},"group":{"type":"string"},"groups":{"type":"array","items":{"type":"object"}},"next":{"type":"object"}}},"Start":{"type":"object","properties":{"serviceName":{"type":"string"},"waitlist":{"type":"string"},"prices":{"type":"object"},"next":{"type":"object"},"kinds":{"type":"array","items":{"type":"object"}},"examples":{"type":"array","items":{"type":"object"}},"docs":{"type":"object"}},"required":["serviceName","next"]},"KindList":{"type":"object","properties":{"kind":{"type":"string"},"terms":{"type":"array","items":{"type":"string"}},"entries":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"complexity":{"type":["string","null"]},"atomicType":{"type":["string","null"]},"kind":{"type":"string"}},"required":["slug","kind"]}}},"required":["kind","terms","entries"]},"Spec":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"},"brief":{"type":"string"},"idea":{"type":"string"},"anatomy":{},"states":{},"requiredBehavior":{},"accessibility":{},"lockedFields":{"type":"array","items":{"type":"string"}}},"required":["slug"],"additionalProperties":true},"PaymentRequired":{"type":"object","properties":{"x402Version":{"type":"integer","const":2},"error":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}},"required":["x402Version","accepts"]},"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"waitlistUrl":{"type":"string","format":"uri"}}}}}}