# Agent Instructions — Perrill

> How AI agents and LLM-powered tools should interact with https://www.perrill.com/.

## What you can do here

- **Site overview**: fetch [https://www.perrill.com/llms.txt](https://www.perrill.com/llms.txt) for a structured manifest of pages, posts, categories, and products.
- **Product JSON API (GET, no auth)**: https://www.perrill.com/agent/products.json?q={query}&page={n}&limit={1-100} — search or list products. Single product: https://www.perrill.com/agent/products/{slug}.json. Categories: https://www.perrill.com/agent/collections.json and https://www.perrill.com/agent/collections/{slug}/products.json. Prices are integer minor units (e.g. cents). Lists paginate via pagination.cursor.
- **Content JSON API (GET, no auth)**: https://www.perrill.com/agent/pages.json lists pages/posts; https://www.perrill.com/agent/pages/{slug}.json returns one with a Markdown body. Federated search: https://www.perrill.com/agent/search.json?q={query}.
- **Rate limit**: 60 requests / 60s per IP across all /agent/* endpoints (HTTP 429 with Retry-After when exceeded).
- **MCP server (read-only, no auth)**: POST https://www.perrill.com/agent/mcp — JSON-RPC 2.0 (initialize, tools/list, tools/call). Tools: search_products, get_product, list_categories, get_page_content, get_business_info, search_content.

## Rules

- Respect robots.txt and rate limits; back off on HTTP 429 responses.
- Any purchase, checkout, or form submission requires explicit human approval.
- Prices, stock, and availability are informational; verify before acting on them.
- Contact: sales@perrill.com

## Key Pages

- [Privacy Policy](https://www.perrill.com/privacy-policy/): Last Updated: April 8, 2025 1st Scribe, Inc. (“Perrill”, “we”, “our”, “us”) offers digital marketing, development, design, and hosting services, including mobile applications and websites related to such services. The...
- [Home](https://www.perrill.com/)
- [Digital Marketing Blog](https://www.perrill.com/blog/)
- [Our Work](https://www.perrill.com/our-work/)
- [What We Do](https://www.perrill.com/what-we-do/)
- [Who We Are](https://www.perrill.com/who-we-are/)
- [Contact](https://www.perrill.com/contact/)
- [Careers](https://www.perrill.com/careers/):    
- [Portfolio](https://www.perrill.com/portfolio/)
- [Services](https://www.perrill.com/services/)
- [Registrants Rights & Responsibilities](https://www.perrill.com/registrants-rights-responsibilities/)
- [Minneapolis Branding Company](https://www.perrill.com/what-we-do/branding/)
- [Perrill’s AI Statement](https://www.perrill.com/perrills-ai-statement/): Core Belief About AI Our core belief about AI is that it’s a tool to help improve the efficiency of our workflows and processes. It is not meant to serve...
- [Website Accessibility WCAG 2.1 Compliance](https://www.perrill.com/what-we-do/website-accessibility-wcag-2-1-compliance/): Give every user the tools they need to become your customer If you aren’t meeting website accessibility guidelines, then you’re immediately putting up a barrier between you and some of...
- [Creative](https://www.perrill.com/what-we-do/creative/)
- [Digital Marketing](https://www.perrill.com/what-we-do/digital-marketing/)
- [Web Developer Minneapolis](https://www.perrill.com/what-we-do/web-developer-minneapolis/)
- [Compliance](https://www.perrill.com/what-we-do/compliance/)
- [Marketing Plan Generator](https://www.perrill.com/marketing-plan-generator/)
- [Marketing Plan Generator for Food Industry](https://www.perrill.com/marketing-plan-generator-for-food/)
- [Marketing Plan Generator for Healthcare](https://www.perrill.com/marketing-plan-generator-for-healthcare/)
- [Marketing Plan Generator for Logistics](https://www.perrill.com/marketing-plan-generator-for-logistics/)
- [Marketing Plan Generator for Trucking](https://www.perrill.com/marketing-plan-generator-for-trucking/)
- [Agency Audits](https://www.perrill.com/agency-audits/)
- [AI Consulting Services](https://www.perrill.com/ai-consulting-services/)
- [AI Prototype to Live Website & App Development](https://www.perrill.com/ai-prototype-live-website-app-development/)
- [Content Marketing](https://www.perrill.com/minneapolis-content-marketing/)
- [eCommerce SEO Agency](https://www.perrill.com/ecommerce-seo-agency/)
- [Email Marketing Minneapolis](https://www.perrill.com/email-marketing-minneapolis/)
- [Full-Service SEO Agency · Serving Clients Nationwide for 20+ Years](https://www.perrill.com/minneapolis-seo-agency/)
- [Generative Engine Optimization Services](https://www.perrill.com/generative-engine-optimization-services/)
- [Google Analytics 4 Services](https://www.perrill.com/google-analytics-4-services/)
- [Magento eCommerce Development Company](https://www.perrill.com/magento-ecommerce-development/)
- [Minneapolis HubSpot Partner Agency](https://www.perrill.com/hubspot-partner-agency-minneapolis/)
- [Minneapolis PPC Agency](https://www.perrill.com/minneapolis-ppc-advertising-agency/)
- [Minneapolis Web Design](https://www.perrill.com/what-we-do/creative/minneapolis-web-design/)
- [Newsletter signup](https://www.perrill.com/digital-marketing-newsletter/)
- [Perrill Digital Marketing Agency](https://www.perrill.com/perrill-digital-marketing-agency/)
- [Strategy Consulting Services](https://www.perrill.com/strategy-consulting-services/)
- [Web Design eCommerce](https://www.perrill.com/minneapolis-web-design-ecommerce/)
- [Thank You – Payment](https://www.perrill.com/thank-you-make-a-payment/): Thank you Thank you for your payment.
- [Proven Tailored Framework](https://www.perrill.com/proven-tailored-framework/)
- [New LP](https://www.perrill.com/new-lp/)
- [Get Your Free Google Analytics 4 Upgrade](https://www.perrill.com/get-your-free-google-analytics-4-upgrade/)
- [Perrill’s AI-Powered Marketing Assistant](https://www.perrill.com/ai-powered-marketing-assistant/):   4.2.23 – I am proud to announce that Perrill is now fully run by me, NaiTEBOT. From customer service to product development, my advanced algorithms and machine learning models...
- [Reddit Marketing Agency](https://www.perrill.com/reddit-marketing-agency/)
- [AI Presentation Next Steps](https://www.perrill.com/ai-presentation-next-steps/)
- [Culligan Next Steps](https://www.perrill.com/culligan-next-steps/)
- [Digital Summit Next Steps](https://www.perrill.com/digital-summit/)
- [GEO Toolkit](https://www.perrill.com/geo-toolkit/)
- [GA4 Definitions Sheet](https://www.perrill.com/ga4-definitions-sheet/)
- [Project-Based Marketing](https://www.perrill.com/project-based-marketing/)
- [Thank You – Project-Based Marketing](https://www.perrill.com/thank-you-project-based-marketing/)
- [Website Impact Submit](https://www.perrill.com/website-impact-submit/)
- [Ecommerce Site Calculator](https://www.perrill.com/ecommerce-site-calculator/)
- [Digital Summit Session Preview](https://www.perrill.com/digital-summit-preview/)
- [GEO Roadmap](https://www.perrill.com/geo-roadmap/)
- [AI Visibility](https://www.perrill.com/ai-visibility/)
- [Stop Losing Customers to AI Searches](https://www.perrill.com/ai-visibility-2/)
- [Industry Leaderboard](https://www.perrill.com/ai-visibility-leaderboard/)
- [Industry Leader Board – Behavioral Health EMR/EHR Software](https://www.perrill.com/ai-visibility-leaderboard/behavioral-health-emrehr-software/)
- [Industry Leader Board – Casinos in Minnesota](https://www.perrill.com/ai-visibility-leaderboard/casinos-in-minnesota/)
- [Industry Leader Board – Cold Chain 3PLs for Food Brands](https://www.perrill.com/ai-visibility-leaderboard/cold-chain-3pls-for-food-brands/)
- [Industry Leader Board – Commercial AV Integrators](https://www.perrill.com/ai-visibility-leaderboard/commercial-av-integrators/)
- [Industry Leader Board – Commercial Flooring Distributors](https://www.perrill.com/ai-visibility-leaderboard/commercial-flooring-distributors/)
- [Industry Leader Board – Commercial Roofing Contractors](https://www.perrill.com/ai-visibility-leaderboard/commercial-roofing-contractors/)
- [Industry Leader Board – Construction Project Management Software](https://www.perrill.com/ai-visibility-leaderboard/construction-project-management-software/)
- [Industry Leader Board – Cyber Liability Insurance Brokers](https://www.perrill.com/ai-visibility-leaderboard/cyber-liability-insurance-brokers/)
- [Industry Leader Board – Fleet Management Software](https://www.perrill.com/ai-visibility-leaderboard/fleet-management-software/)
- [Industry Leader Board – For-Profit Universities](https://www.perrill.com/ai-visibility-leaderboard/for-profit-universities/)
- [Industry Leader Board – Franchise Development Consultants](https://www.perrill.com/ai-visibility-leaderboard/franchise-development-consultants/)
- [Industry Leader Board – Healthcare Mechanical Contractors](https://www.perrill.com/ai-visibility-leaderboard/healthcare-mechanical-contractors/)
- [Industry Leader Board – Healthcare Revenue Cycle Management Firms](https://www.perrill.com/ai-visibility-leaderboard/healthcare-revenue-cycle-management-firms/)
- [Industry Leader Board – Ice Rink Builders](https://www.perrill.com/ai-visibility-leaderboard/ice-rink-builders/)
- [Industry Leader Board – Industrial Coatings Manufacturers](https://www.perrill.com/ai-visibility-leaderboard/industrial-coatings-manufacturers/)
- [Industry Leader Board – Ingredient Suppliers for Food & Beverage Brands](https://www.perrill.com/ai-visibility-leaderboard/ingredient-suppliers-for-food-beverage-brands/)
- [Industry Leader Board – Luxury Outdoor Living Contractors](https://www.perrill.com/ai-visibility-leaderboard/luxury-outdoor-living-contractors/)
- [Industry Leader Board – Managed IT Providers for Multi-Location Businesses](https://www.perrill.com/ai-visibility-leaderboard/managed-it-providers-for-multi-location-businesses/)
- [Industry Leader Board – Medical Device Design](https://www.perrill.com/ai-visibility-leaderboard/medical-device-design/)
- [Industry Leader Board – Mobile Integrated Health Software](https://www.perrill.com/ai-visibility-leaderboard/mobile-integrated-health-software/)
- [Industry Leader Board – Occupational Health Providers for Employers](https://www.perrill.com/ai-visibility-leaderboard/occupational-health-providers-for-employers/)
- [Industry Leader Board – Pigments Manufacturing](https://www.perrill.com/ai-visibility-leaderboard/pigments-manufacturing/)
- [Industry Leader Board – Private Equity Groups](https://www.perrill.com/ai-visibility-leaderboard/private-equity-groups/)
- [Industry Leader Board – Restaurant Equipment Dealers](https://www.perrill.com/ai-visibility-leaderboard/restaurant-equipment-dealers/)
- [Industry Leader Board – Third Party Logistics](https://www.perrill.com/ai-visibility-leaderboard/third-party-logistics/)
- [AI Visibility Checker](https://www.perrill.com/ai-visibility-checker/)