{"id":146,"date":"2026-09-22T20:53:16","date_gmt":"2026-09-22T20:53:16","guid":{"rendered":"https:\/\/buildanythinginstantly.com\/index.php\/docs\/"},"modified":"2026-09-22T20:53:16","modified_gmt":"2026-09-22T20:53:16","slug":"docs","status":"publish","type":"page","link":"https:\/\/buildanythinginstantly.com\/index.php\/docs\/","title":{"rendered":"Docs"},"content":{"rendered":"<div class=\"sp-docs\"><nav class=\"sp-docs__toc\" aria-label=\"On this page\"><ul><li><a href=\"#sp-quick-start\">Quick start<\/a><\/li><li><a href=\"#sp-mcp\">Connect an AI agent<\/a><\/li><li><a href=\"#sp-tools\">MCP tools<\/a><\/li><li><a href=\"#sp-rest\">REST API<\/a><\/li><li><a href=\"#sp-examples\">Examples<\/a><\/li><li><a href=\"#sp-discovery\">Discovery files<\/a><\/li><li><a href=\"#sp-limits\">Limits and etiquette<\/a><\/li><li><a href=\"#sp-affiliate\">Affiliate links and disclosure<\/a><\/li><\/ul><\/nav><section id=\"sp-quick-start\"><h2>Quick start<\/h2><p>ShopPilot finds products, compares them and returns a real Amazon buy link with this site&#039;s affiliate tag. It works two ways: a plain web API, and an MCP server that AI agents such as Claude can connect to.<\/p><ol><li>Ask for something, for example &quot;wireless mouse under $30&quot;.<\/li><li>Compare two or more results side by side.<\/li><li>Open the buy link. If you already have an Amazon product URL or ASIN, paste it and you get the proper buy link back.<\/li><\/ol><\/section><section id=\"sp-mcp\"><h2>Connect an AI agent (MCP)<\/h2><p>The MCP endpoint is <code>https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/mcp<\/code>. It uses the Streamable HTTP transport (JSON-RPC 2.0 over POST) and needs no login.<\/p><h3>Claude (web and desktop)<\/h3><p>Open Settings, then Connectors, choose &quot;Add custom connector&quot; and paste this URL. Claude connects from the cloud, so the site must be reachable on the public internet over HTTPS.<\/p><pre class=\"sp-code\"><code class=\"language-text\">https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/mcp<\/code><\/pre><h3>Claude Code<\/h3><p>Works with local sites too (for example http:\/\/localhost:8080).<\/p><pre class=\"sp-code\"><code class=\"language-bash\">claude mcp add --transport http shoppilot https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/mcp<\/code><\/pre><h3>Any MCP client (JSON config)<\/h3><p>For clients that support remote Streamable HTTP servers, such as a project .mcp.json file.<\/p><pre class=\"sp-code\"><code class=\"language-json\">{\n    &quot;mcpServers&quot;: {\n        &quot;shoppilot&quot;: {\n            &quot;type&quot;: &quot;http&quot;,\n            &quot;url&quot;: &quot;https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/mcp&quot;\n        }\n    }\n}<\/code><\/pre><h3>Clients that only speak stdio<\/h3><p>The mcp-remote bridge lets stdio-only clients use the remote server. Requires Node.js.<\/p><pre class=\"sp-code\"><code class=\"language-json\">{\n    &quot;mcpServers&quot;: {\n        &quot;shoppilot&quot;: {\n            &quot;command&quot;: &quot;npx&quot;,\n            &quot;args&quot;: [\n                &quot;-y&quot;,\n                &quot;mcp-remote&quot;,\n                &quot;https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/mcp&quot;\n            ]\n        }\n    }\n}<\/code><\/pre><h3>Test with cURL<\/h3><p>Lists the available tools.<\/p><pre class=\"sp-code\"><code class=\"language-bash\">curl -s -X POST &#039;https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/mcp&#039; \\\n  -H &#039;Content-Type: application\/json&#039; \\\n  -H &#039;Accept: application\/json, text\/event-stream&#039; \\\n  -d &#039;{&quot;jsonrpc&quot;:&quot;2.0&quot;,&quot;id&quot;:1,&quot;method&quot;:&quot;tools\\\/list&quot;}&#039;<\/code><\/pre><\/section><section id=\"sp-tools\"><h2>MCP tools<\/h2><p>All tools are read-only. Nothing is purchased or changed on your behalf.<\/p><dl class=\"sp-docs__tools\"><dt><code>search_products<\/code><\/dt><dd>Search for products to buy (for example &quot;wireless mouse under $30&quot;). Returns a ranked shortlist. Every result includes price, ratings when known, why it ranked, and the real Amazon purchase link in `buy_url` (already carrying the site&#039;s affiliate tag) plus an `add_to_cart_url`. Present `buy_url` to the user as the link to buy. Price limits can be written in the query or passed as max_price \/ min_price.<\/dd><dt><code>find_and_compare<\/code><\/dt><dd>One call for the whole shopping flow: search, take the top matches, and compare them side by side with a verdict (best overall, best value, lowest price, top rated) and a buy link for each. Best default when the user asks &quot;what should I buy?&quot;.<\/dd><dt><code>compare_products<\/code><\/dt><dd>Compare 2 to 6 specific products side by side. Each item can be an ASIN or an Amazon product URL. Returns an attribute table, a verdict and a buy link for each.<\/dd><dt><code>get_buy_link<\/code><\/dt><dd>Turn an ASIN, an Amazon product URL (any marketplace) or an amzn.to \/ a.co short link into a proper purchase link with the site&#039;s affiliate tag, plus an add-to-cart link. Use this when the user already has a product in mind.<\/dd><dt><code>get_product_details<\/code><\/dt><dd>Details for one product (price, features, specs, pros and cons when known) plus its buy link. Accepts an ASIN or an Amazon product URL.<\/dd><\/dl><\/section><section id=\"sp-rest\"><h2>REST API<\/h2><p>Base URL: <code>https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1<\/code><\/p><div class=\"sp-docs__table\"><table><thead><tr><th>Method<\/th><th>Path<\/th><th>Parameters<\/th><th>Returns<\/th><\/tr><\/thead><tbody><tr><td>GET<\/td><td><code>\/search<\/code><\/td><td>q, limit, min_price, max_price, sort, prime_only, marketplace<\/td><td>Ranked matches with reasons and badges.<\/td><\/tr><tr><td>GET<\/td><td><code>\/products\/{asin}<\/code><\/td><td>marketplace<\/td><td>One product.<\/td><\/tr><tr><td>GET\/POST<\/td><td><code>\/resolve<\/code><\/td><td>input<\/td><td>Turns an ASIN, Amazon URL or short link into an ASIN and buy link.<\/td><\/tr><tr><td>GET\/POST<\/td><td><code>\/buy-link<\/code><\/td><td>input, quantity, marketplace<\/td><td>The buy link (and add-to-cart link) for a product.<\/td><\/tr><tr><td>GET\/POST<\/td><td><code>\/compare<\/code><\/td><td>items[] (2 to 6)<\/td><td>Side-by-side comparison with a verdict.<\/td><\/tr><tr><td>GET\/POST<\/td><td><code>\/shortlist<\/code><\/td><td>q, count, max_price<\/td><td>Search plus comparison in one call.<\/td><\/tr><tr><td>GET<\/td><td><code>\/health<\/code><\/td><td><\/td><td>Status of the service and its data sources.<\/td><\/tr><\/tbody><\/table><\/div><p>Every response includes ok, the disclosure text, a price notice and a timestamp. Errors use the standard WordPress REST format with a code and message.<\/p><\/section><section id=\"sp-examples\"><h2>Examples<\/h2><h3>Search<\/h3><pre class=\"sp-code\"><code class=\"language-bash\">curl -G &#039;https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/search&#039; --data-urlencode &#039;q=wireless mouse under $30&#039;<\/code><\/pre><h3>Turn any Amazon link into a buy link<\/h3><pre class=\"sp-code\"><code class=\"language-bash\">curl -G &#039;https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/buy-link&#039; --data-urlencode &#039;input=https:\/\/www.amazon.com\/dp\/B08N5WRWNW&#039;<\/code><\/pre><h3>Compare<\/h3><pre class=\"sp-code\"><code class=\"language-bash\">curl -X POST &#039;https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/shoppilot\/v1\/compare&#039; \\\n  -H &#039;Content-Type: application\/json&#039; \\\n  -d &#039;{&quot;items&quot;:[&quot;B08N5WRWNW&quot;,&quot;B07XJ8C8F5&quot;]}&#039;<\/code><\/pre><\/section><section id=\"sp-discovery\"><h2>Discovery files<\/h2><p>Agents and crawlers can find everything from these standard locations:<\/p><ul><li><a href=\"https:\/\/buildanythinginstantly.com\/llms.txt\">llms.txt<\/a> <code>https:\/\/buildanythinginstantly.com\/llms.txt<\/code><\/li><li><a href=\"https:\/\/buildanythinginstantly.com\/openapi.json\">OpenAPI 3.1<\/a> <code>https:\/\/buildanythinginstantly.com\/openapi.json<\/code><\/li><li><a href=\"https:\/\/buildanythinginstantly.com\/.well-known\/mcp\/server-card.json\">MCP server card<\/a> <code>https:\/\/buildanythinginstantly.com\/.well-known\/mcp\/server-card.json<\/code><\/li><li><a href=\"https:\/\/buildanythinginstantly.com\/.well-known\/api-catalog\">API catalog (RFC 9727)<\/a> <code>https:\/\/buildanythinginstantly.com\/.well-known\/api-catalog<\/code><\/li><\/ul><\/section><section id=\"sp-limits\"><h2>Limits and etiquette<\/h2><ul><li>Rate limit: 60 requests per minute per client. The X-RateLimit-* headers show what is left.<\/li><li>Up to 10 results per search and 6 products per comparison.<\/li><li>Prices change. Always show the final price from Amazon and tell people to confirm it before buying.<\/li><\/ul><\/section><section id=\"sp-affiliate\"><h2>Affiliate links and disclosure<\/h2><p>Buy links carry this site&#039;s Amazon Associates tag, so the site earns a commission on qualifying purchases at no extra cost to the buyer. Agents should show the buy_url exactly as returned and keep the disclosure with it.<\/p><p><em>As an Amazon Associate I earn from qualifying purchases.<\/em><\/p><\/section><\/div>\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-146","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/wp\/v2\/pages\/146","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/wp\/v2\/comments?post=146"}],"version-history":[{"count":0,"href":"https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/wp\/v2\/pages\/146\/revisions"}],"wp:attachment":[{"href":"https:\/\/buildanythinginstantly.com\/index.php\/wp-json\/wp\/v2\/media?parent=146"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}