[{"data":1,"prerenderedAt":1003},["ShallowReactive",2],{"navigation_docs":3,"-mcp-tools-get-icon-url":194,"-mcp-tools-get-icon-url-surround":998},[4,22,82,124,146,168,190],{"title":5,"path":6,"stem":7,"children":8},"Getting started","/getting-started","1.getting-started/0.index",[9,10,14,18],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"MCP quickstart","/getting-started/mcp-quickstart","1.getting-started/1.mcp-quickstart",{"title":15,"path":16,"stem":17},"REST quickstart","/getting-started/rest-quickstart","1.getting-started/2.rest-quickstart",{"title":19,"path":20,"stem":21},"UI quickstart","/getting-started/ui-quickstart","1.getting-started/3.ui-quickstart",{"title":23,"path":24,"stem":25,"children":26},"MCP server","/mcp","2.mcp/0.index",[27,28,32,36,40],{"title":23,"path":24,"stem":25},{"title":29,"path":30,"stem":31},"Connecting","/mcp/connection","2.mcp/1.connection",{"title":33,"path":34,"stem":35},"Envelope","/mcp/envelope","2.mcp/2.envelope",{"title":37,"path":38,"stem":39},"Resources","/mcp/resources","2.mcp/3.resources",{"title":41,"path":42,"stem":43,"children":44},"Tools","/mcp/tools","2.mcp/4.tools/0.index",[45,46,50,54,58,62,66,70,74,78],{"title":41,"path":42,"stem":43},{"title":47,"path":48,"stem":49},"list_schema_versions","/mcp/tools/list-schema-versions","2.mcp/4.tools/1.list-schema-versions",{"title":51,"path":52,"stem":53},"get_schema","/mcp/tools/get-schema","2.mcp/4.tools/2.get-schema",{"title":55,"path":56,"stem":57},"list_categories","/mcp/tools/list-categories","2.mcp/4.tools/3.list-categories",{"title":59,"path":60,"stem":61},"list_elements","/mcp/tools/list-elements","2.mcp/4.tools/4.list-elements",{"title":63,"path":64,"stem":65},"get_element","/mcp/tools/get-element","2.mcp/4.tools/5.get-element",{"title":67,"path":68,"stem":69},"get_elements","/mcp/tools/get-elements","2.mcp/4.tools/6.get-elements",{"title":71,"path":72,"stem":73},"validate_datachain","/mcp/tools/validate-datachain","2.mcp/4.tools/7.validate-datachain",{"title":75,"path":76,"stem":77},"render_datachain","/mcp/tools/render-datachain","2.mcp/4.tools/8.render-datachain",{"title":79,"path":80,"stem":81},"get_icon_url","/mcp/tools/get-icon-url","2.mcp/4.tools/9.get-icon-url",{"title":83,"path":84,"stem":85,"children":86},"REST API (v2)","/rest","3.rest/0.index",[87,88,92,96,100,104,108,112,116,120],{"title":83,"path":84,"stem":85},{"title":89,"path":90,"stem":91},"GET /schemas","/rest/schemas","3.rest/1.schemas",{"title":93,"path":94,"stem":95},"GET /schemas/:version/manifest","/rest/manifest","3.rest/2.manifest",{"title":97,"path":98,"stem":99},"GET /schemas/:version/categories","/rest/categories","3.rest/3.categories",{"title":101,"path":102,"stem":103},"GET /schemas/:version/elements","/rest/elements-list","3.rest/4.elements-list",{"title":105,"path":106,"stem":107},"GET /schemas/:version/elements/:element_id","/rest/element-detail","3.rest/5.element-detail",{"title":109,"path":110,"stem":111},"POST /schemas/:version/validate","/rest/validate","3.rest/6.validate",{"title":113,"path":114,"stem":115},"Icon routes","/rest/icons","3.rest/7.icons",{"title":117,"path":118,"stem":119},"Pagination & fields","/rest/pagination-and-fields","3.rest/8.pagination-and-fields",{"title":121,"path":122,"stem":123},"Errors","/rest/errors","3.rest/9.errors",{"title":125,"path":126,"stem":127,"children":128},"Icon composition","/icons","4.icons/0.index",[129,130,134,138,142],{"title":125,"path":126,"stem":127},{"title":131,"path":132,"stem":133},"Shapes","/icons/shapes","4.icons/1.shapes",{"title":135,"path":136,"stem":137},"Symbols","/icons/symbols","4.icons/2.symbols",{"title":139,"path":140,"stem":141},"Composed variants","/icons/composed-variants","4.icons/3.composed-variants",{"title":143,"path":144,"stem":145},"URLs","/icons/urls","4.icons/4.urls",{"title":147,"path":148,"stem":149,"children":150},"@dtpr/ui","/ui","5.ui/0.index",[151,152,156,160,164],{"title":147,"path":148,"stem":149},{"title":153,"path":154,"stem":155},"@dtpr/ui/core","/ui/core","5.ui/1.core",{"title":157,"path":158,"stem":159},"@dtpr/ui/vue","/ui/vue","5.ui/2.vue",{"title":161,"path":162,"stem":163},"@dtpr/ui/html","/ui/html","5.ui/3.html",{"title":165,"path":166,"stem":167},"Theming","/ui/theming","5.ui/4.theming",{"title":169,"path":170,"stem":171,"children":172},"Concepts","/concepts","6.concepts/0.index",[173,174,178,182,186],{"title":169,"path":170,"stem":171},{"title":175,"path":176,"stem":177},"Datachains","/concepts/datachains","6.concepts/1.datachains",{"title":179,"path":180,"stem":181},"Elements & categories","/concepts/elements-categories","6.concepts/2.elements-categories",{"title":183,"path":184,"stem":185},"Versions & releases","/concepts/versions-and-releases","6.concepts/3.versions-and-releases",{"title":187,"path":188,"stem":189},"Content hash","/concepts/content-hash","6.concepts/4.content-hash",{"title":191,"path":192,"stem":193},"Changelog","/changelog","7.changelog",{"id":195,"title":79,"body":196,"description":991,"extension":992,"links":993,"meta":994,"navigation":995,"path":80,"seo":996,"stem":81,"__hash__":997},"docs/2.mcp/4.tools/9.get-icon-url.md",{"type":197,"value":198,"toc":983},"minimark",[199,202,212,217,242,246,327,331,564,567,652,656,947,951,979],[200,201,79],"h1",{"id":79},[203,204,206,207,211],"callout",{"type":205},"info","Handy when you want a single URL to hand off to an image renderer or ",[208,209,210],"code",{},"\u003Cimg>"," tag. The returned URL is the REST icon route.",[213,214,216],"h2",{"id":215},"summary","Summary",[218,219,220,221,224,225,228,229,233,234,237,238,241],"p",{},"Given a ",[208,222,223],{},"(version, element_id, variant?)"," triple, returns the composed-icon URL, the content type, and the full ",[208,226,227],{},"valid_variants"," list for that element. The returned URL is ",[230,231,232],"strong",{},"relative"," (",[208,235,236],{},"/api/v2/…","); prefix ",[208,239,240],{},"https://api.dtpr.io"," to fetch.",[213,243,245],{"id":244},"input","Input",[247,248,249,268],"table",{},[250,251,252],"thead",{},[253,254,255,259,262,265],"tr",{},[256,257,258],"th",{},"Field",[256,260,261],{},"Type",[256,263,264],{},"Required",[256,266,267],{},"Description",[269,270,271,290,310],"tbody",{},[253,272,273,279,284,287],{},[274,275,276],"td",{},[208,277,278],{},"version",[274,280,281],{},[208,282,283],{},"string",[274,285,286],{},"yes",[274,288,289],{},"Schema version.",[253,291,292,297,301,303],{},[274,293,294],{},[208,295,296],{},"element_id",[274,298,299],{},[208,300,283],{},[274,302,286],{},[274,304,305,306,309],{},"Whitelisted to ",[208,307,308],{},"[a-zA-Z0-9_-]",".",[253,311,312,317,321,324],{},[274,313,314],{},[208,315,316],{},"variant",[274,318,319],{},[208,320,283],{},[274,322,323],{},"no",[274,325,326],{},"Variant key. Omit for the default icon.",[213,328,330],{"id":329},"output","Output",[332,333,338],"pre",{"className":334,"code":335,"language":336,"meta":337,"style":337},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"ok\": true,\n  \"data\": {\n    \"url\": \"/api/v2/schemas/ai@2026-04-16-beta/elements/purpose.example/icon.svg\",\n    \"content_type\": \"image/svg+xml\",\n    \"variant\": \"default\",\n    \"valid_variants\": [\"default\", \"dark\", \"commercial\", \"civic\"]\n  },\n  \"meta\": { \"content_hash\": \"sha256-…\", \"version\": \"ai@2026-04-16-beta\" }\n}\n","json","",[208,339,340,349,368,383,409,430,450,501,507,558],{"__ignoreMap":337},[341,342,345],"span",{"class":343,"line":344},"line",1,[341,346,348],{"class":347},"sMK4o","{\n",[341,350,352,355,359,362,365],{"class":343,"line":351},2,[341,353,354],{"class":347},"  \"",[341,356,358],{"class":357},"spNyl","ok",[341,360,361],{"class":347},"\"",[341,363,364],{"class":347},":",[341,366,367],{"class":347}," true,\n",[341,369,371,373,376,378,380],{"class":343,"line":370},3,[341,372,354],{"class":347},[341,374,375],{"class":357},"data",[341,377,361],{"class":347},[341,379,364],{"class":347},[341,381,382],{"class":347}," {\n",[341,384,386,389,393,395,397,400,404,406],{"class":343,"line":385},4,[341,387,388],{"class":347},"    \"",[341,390,392],{"class":391},"sBMFI","url",[341,394,361],{"class":347},[341,396,364],{"class":347},[341,398,399],{"class":347}," \"",[341,401,403],{"class":402},"sfazB","/api/v2/schemas/ai@2026-04-16-beta/elements/purpose.example/icon.svg",[341,405,361],{"class":347},[341,407,408],{"class":347},",\n",[341,410,412,414,417,419,421,423,426,428],{"class":343,"line":411},5,[341,413,388],{"class":347},[341,415,416],{"class":391},"content_type",[341,418,361],{"class":347},[341,420,364],{"class":347},[341,422,399],{"class":347},[341,424,425],{"class":402},"image/svg+xml",[341,427,361],{"class":347},[341,429,408],{"class":347},[341,431,433,435,437,439,441,443,446,448],{"class":343,"line":432},6,[341,434,388],{"class":347},[341,436,316],{"class":391},[341,438,361],{"class":347},[341,440,364],{"class":347},[341,442,399],{"class":347},[341,444,445],{"class":402},"default",[341,447,361],{"class":347},[341,449,408],{"class":347},[341,451,453,455,457,459,461,464,466,468,470,473,475,478,480,482,484,487,489,491,493,496,498],{"class":343,"line":452},7,[341,454,388],{"class":347},[341,456,227],{"class":391},[341,458,361],{"class":347},[341,460,364],{"class":347},[341,462,463],{"class":347}," [",[341,465,361],{"class":347},[341,467,445],{"class":402},[341,469,361],{"class":347},[341,471,472],{"class":347},",",[341,474,399],{"class":347},[341,476,477],{"class":402},"dark",[341,479,361],{"class":347},[341,481,472],{"class":347},[341,483,399],{"class":347},[341,485,486],{"class":402},"commercial",[341,488,361],{"class":347},[341,490,472],{"class":347},[341,492,399],{"class":347},[341,494,495],{"class":402},"civic",[341,497,361],{"class":347},[341,499,500],{"class":347},"]\n",[341,502,504],{"class":343,"line":503},8,[341,505,506],{"class":347},"  },\n",[341,508,510,512,515,517,519,522,524,527,529,531,533,536,538,540,542,544,546,548,550,553,555],{"class":343,"line":509},9,[341,511,354],{"class":347},[341,513,514],{"class":357},"meta",[341,516,361],{"class":347},[341,518,364],{"class":347},[341,520,521],{"class":347}," {",[341,523,399],{"class":347},[341,525,526],{"class":391},"content_hash",[341,528,361],{"class":347},[341,530,364],{"class":347},[341,532,399],{"class":347},[341,534,535],{"class":402},"sha256-…",[341,537,361],{"class":347},[341,539,472],{"class":347},[341,541,399],{"class":347},[341,543,278],{"class":391},[341,545,361],{"class":347},[341,547,364],{"class":347},[341,549,399],{"class":347},[341,551,552],{"class":402},"ai@2026-04-16-beta",[341,554,361],{"class":347},[341,556,557],{"class":347}," }\n",[341,559,561],{"class":343,"line":560},10,[341,562,563],{"class":347},"}\n",[213,565,121],{"id":566},"errors",[247,568,569,582],{},[250,570,571],{},[253,572,573,576,579],{},[256,574,575],{},"Code",[256,577,578],{},"Meaning",[256,580,581],{},"Fix",[269,583,584,597,612,627],{},[253,585,586,591,594],{},[274,587,588],{},[208,589,590],{},"invalid_arguments",[274,592,593],{},"Missing / malformed arguments.",[274,595,596],{},"Fix the call.",[253,598,599,604,607],{},[274,600,601],{},[208,602,603],{},"unknown_version",[274,605,606],{},"Version is not registered.",[274,608,609,610,309],{},"Call ",[208,611,47],{},[253,613,614,619,622],{},[274,615,616],{},[208,617,618],{},"element_not_found",[274,620,621],{},"No element with that id.",[274,623,624,625,309],{},"Use ",[208,626,59],{},[253,628,629,634,637],{},[274,630,631],{},[208,632,633],{},"unknown_variant",[274,635,636],{},"Variant not valid for this element.",[274,638,639,640,642,643,645,646,649,650,309],{},"Inspect ",[208,641,227],{}," in the error ",[208,644,514],{}," or read ",[208,647,648],{},"icon_variants"," via ",[208,651,63],{},[213,653,655],{"id":654},"example","Example",[657,658,659,768],"code-group",{},[332,660,665],{"className":661,"code":662,"filename":663,"language":664,"meta":337,"style":337},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -s https://api.dtpr.io/mcp \\\n  -H 'content-type: application/json' \\\n  --data '{\n    \"jsonrpc\":\"2.0\",\"id\":1,\n    \"method\":\"tools/call\",\n    \"params\":{\n      \"name\":\"get_icon_url\",\n      \"arguments\":{\n        \"version\":\"ai@2026-04-16-beta\",\n        \"element_id\":\"purpose.example\",\n        \"variant\":\"dark\"\n      }\n    }\n  }'\n","curl","bash",[208,666,667,681,697,706,711,716,721,726,731,736,741,747,753,759],{"__ignoreMap":337},[341,668,669,671,674,677],{"class":343,"line":344},[341,670,663],{"class":391},[341,672,673],{"class":402}," -s",[341,675,676],{"class":402}," https://api.dtpr.io/mcp",[341,678,680],{"class":679},"sTEyZ"," \\\n",[341,682,683,686,689,692,695],{"class":343,"line":351},[341,684,685],{"class":402},"  -H",[341,687,688],{"class":347}," '",[341,690,691],{"class":402},"content-type: application/json",[341,693,694],{"class":347},"'",[341,696,680],{"class":679},[341,698,699,702,704],{"class":343,"line":370},[341,700,701],{"class":402},"  --data",[341,703,688],{"class":347},[341,705,348],{"class":402},[341,707,708],{"class":343,"line":385},[341,709,710],{"class":402},"    \"jsonrpc\":\"2.0\",\"id\":1,\n",[341,712,713],{"class":343,"line":411},[341,714,715],{"class":402},"    \"method\":\"tools/call\",\n",[341,717,718],{"class":343,"line":432},[341,719,720],{"class":402},"    \"params\":{\n",[341,722,723],{"class":343,"line":452},[341,724,725],{"class":402},"      \"name\":\"get_icon_url\",\n",[341,727,728],{"class":343,"line":503},[341,729,730],{"class":402},"      \"arguments\":{\n",[341,732,733],{"class":343,"line":509},[341,734,735],{"class":402},"        \"version\":\"ai@2026-04-16-beta\",\n",[341,737,738],{"class":343,"line":560},[341,739,740],{"class":402},"        \"element_id\":\"purpose.example\",\n",[341,742,744],{"class":343,"line":743},11,[341,745,746],{"class":402},"        \"variant\":\"dark\"\n",[341,748,750],{"class":343,"line":749},12,[341,751,752],{"class":402},"      }\n",[341,754,756],{"class":343,"line":755},13,[341,757,758],{"class":402},"    }\n",[341,760,762,765],{"class":343,"line":761},14,[341,763,764],{"class":402},"  }",[341,766,767],{"class":347},"'\n",[332,769,772],{"className":334,"code":770,"filename":771,"language":336,"meta":337,"style":337},"{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"get_icon_url\",\n    \"arguments\": {\n      \"version\": \"ai@2026-04-16-beta\",\n      \"element_id\": \"purpose.example\",\n      \"variant\": \"commercial\"\n    }\n  }\n}\n","tools/call",[208,773,774,778,798,815,834,847,866,879,898,917,934,938,943],{"__ignoreMap":337},[341,775,776],{"class":343,"line":344},[341,777,348],{"class":347},[341,779,780,782,785,787,789,791,794,796],{"class":343,"line":351},[341,781,354],{"class":347},[341,783,784],{"class":357},"jsonrpc",[341,786,361],{"class":347},[341,788,364],{"class":347},[341,790,399],{"class":347},[341,792,793],{"class":402},"2.0",[341,795,361],{"class":347},[341,797,408],{"class":347},[341,799,800,802,805,807,809,813],{"class":343,"line":370},[341,801,354],{"class":347},[341,803,804],{"class":357},"id",[341,806,361],{"class":347},[341,808,364],{"class":347},[341,810,812],{"class":811},"sbssI"," 1",[341,814,408],{"class":347},[341,816,817,819,822,824,826,828,830,832],{"class":343,"line":385},[341,818,354],{"class":347},[341,820,821],{"class":357},"method",[341,823,361],{"class":347},[341,825,364],{"class":347},[341,827,399],{"class":347},[341,829,771],{"class":402},[341,831,361],{"class":347},[341,833,408],{"class":347},[341,835,836,838,841,843,845],{"class":343,"line":411},[341,837,354],{"class":347},[341,839,840],{"class":357},"params",[341,842,361],{"class":347},[341,844,364],{"class":347},[341,846,382],{"class":347},[341,848,849,851,854,856,858,860,862,864],{"class":343,"line":432},[341,850,388],{"class":347},[341,852,853],{"class":391},"name",[341,855,361],{"class":347},[341,857,364],{"class":347},[341,859,399],{"class":347},[341,861,79],{"class":402},[341,863,361],{"class":347},[341,865,408],{"class":347},[341,867,868,870,873,875,877],{"class":343,"line":452},[341,869,388],{"class":347},[341,871,872],{"class":391},"arguments",[341,874,361],{"class":347},[341,876,364],{"class":347},[341,878,382],{"class":347},[341,880,881,884,886,888,890,892,894,896],{"class":343,"line":503},[341,882,883],{"class":347},"      \"",[341,885,278],{"class":811},[341,887,361],{"class":347},[341,889,364],{"class":347},[341,891,399],{"class":347},[341,893,552],{"class":402},[341,895,361],{"class":347},[341,897,408],{"class":347},[341,899,900,902,904,906,908,910,913,915],{"class":343,"line":509},[341,901,883],{"class":347},[341,903,296],{"class":811},[341,905,361],{"class":347},[341,907,364],{"class":347},[341,909,399],{"class":347},[341,911,912],{"class":402},"purpose.example",[341,914,361],{"class":347},[341,916,408],{"class":347},[341,918,919,921,923,925,927,929,931],{"class":343,"line":560},[341,920,883],{"class":347},[341,922,316],{"class":811},[341,924,361],{"class":347},[341,926,364],{"class":347},[341,928,399],{"class":347},[341,930,486],{"class":402},[341,932,933],{"class":347},"\"\n",[341,935,936],{"class":343,"line":743},[341,937,758],{"class":347},[341,939,940],{"class":343,"line":749},[341,941,942],{"class":347},"  }\n",[341,944,945],{"class":343,"line":755},[341,946,563],{"class":347},[213,948,950],{"id":949},"see-also","See also",[952,953,954,962,973],"ul",{},[955,956,957,961],"li",{},[958,959,960],"a",{"href":144},"Icon URLs"," — URL layout and variant discovery.",[955,963,964,966,967,969,970,972],{},[958,965,139],{"href":140}," — ",[208,968,445],{}," / ",[208,971,477],{}," / context colors.",[955,974,975,978],{},[958,976,977],{"href":114},"REST icon routes"," — the underlying HTTP surface.",[980,981,982],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":337,"searchDepth":351,"depth":351,"links":984},[985,986,987,988,989,990],{"id":215,"depth":351,"text":216},{"id":244,"depth":351,"text":245},{"id":329,"depth":351,"text":330},{"id":566,"depth":351,"text":121},{"id":654,"depth":351,"text":655},{"id":949,"depth":351,"text":950},"Resolve a composed-icon URL for an element + optional variant.","md",null,{},true,{"title":79,"description":991},"FoDF4u_IZCqx15IU0t6eIb-0-1Sc55606uBLBevRHcA",[999,1001],{"title":75,"path":76,"stem":77,"description":1000,"children":-1},"Render a datachain instance as an MCP App HTML document served via resources/read.",{"title":83,"path":84,"stem":85,"description":1002,"children":-1},"Overview of the DTPR v2 REST API — base URL, headers, authentication, CORS.",1776525925051]