Guppy is built on a few core beliefs about the future of commerce and agents.
Stateful by Default
In the real world, transactions aren’t instantaneous. Inventory flickers, prices change, and queues happen. Guppy’s stateful intents allow agents to express goals that persist over time.
Execution-Agnostic
The web is fragmented. Some merchants have great APIs; others have legacy UIs. Guppy abstracts this away, routing execution through the best available path—whether that’s a direct API call or a browser-based workflow.
Payment-Safe
Giving an agent spend authority is high-risk. Guppy minimizes this risk with constrained, delegated spend. Charges are tied 1:1 to intents and never exceed user-defined guardrails.
Proof-First
Every action taken by Guppy is verifiable. We provide cryptographic proof, merchant receipts, and execution artifacts (like screenshots) for every transaction.
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Guppy","colors":{"primary":"#0b0b0c","light":"#ffffff","dark":"#0b0b0c"},"logo":{"light":"https://mintcdn.com/guppy/_rjB0PG4NviXv9wj/logo/icon.png?fit=max\u0026auto=format\u0026n=_rjB0PG4NviXv9wj\u0026q=85\u0026s=da5f85d4addc60777431aad28e12b865","dark":"https://mintcdn.com/guppy/_rjB0PG4NviXv9wj/logo/icon.png?fit=max\u0026auto=format\u0026n=_rjB0PG4NviXv9wj\u0026q=85\u0026s=da5f85d4addc60777431aad28e12b865"},"favicon":"/favicon.png","navbar":{"links":[{"label":"Support","href":"mailto:support@guppy.ai"}],"primary":{"type":"button","label":"Get API Key","href":"mailto:developers@guppy.ai"}},"footer":{"socials":{"twitter":"https://x.com/guppy_ai","github":"https://github.com/guppy-ai"}},"seo":{"metatags":{"robots":"noindex"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"guppy","hasAudioNarration":false,"actualSubdomain":"guppy","customDomains":["docs.guppyapi.com"],"gitSource":{"type":"github","owner":"claykohut","repo":"guppy","deployBranch":"main","contentDirectory":"apps/api-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae945b1e5b11aa510b3cd74:success","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API Reference","count":12},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Reliability","count":4},{"language":"default","tag":"Capabilities","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"design-principles","slug":"/design-principles","pageMetadata":{"title":"Design Principles","description":"The philosophy behind Guppy","href":"/design-principles","hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The philosophy behind Guppy\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Guppy is built on a few core beliefs about the future of commerce and agents.`}),`\n`,_jsx(Heading,{level:`3`,id:`stateful-by-default`,children:`Stateful by Default`}),`\n`,_jsx(_components.p,{children:`In the real world, transactions aren’t instantaneous. Inventory flickers, prices change, and queues happen. Guppy’s stateful intents allow agents to express goals that persist over time.`}),`\n`,_jsx(Heading,{level:`3`,id:`execution-agnostic`,children:`Execution-Agnostic`}),`\n`,_jsx(_components.p,{children:`The web is fragmented. Some merchants have great APIs; others have legacy UIs. Guppy abstracts this away, routing execution through the best available path—whether that’s a direct API call or a browser-based workflow.`}),`\n`,_jsx(Heading,{level:`3`,id:`payment-safe`,children:`Payment-Safe`}),`\n`,_jsx(_components.p,{children:`Giving an agent spend authority is high-risk. Guppy minimizes this risk with constrained, delegated spend. Charges are tied 1:1 to intents and never exceed user-defined guardrails.`}),`\n`,_jsx(Heading,{level:`3`,id:`proof-first`,children:`Proof-First`}),`\n`,_jsx(_components.p,{children:`Every action taken by Guppy is verifiable. We provide cryptographic proof, merchant receipts, and execution artifacts (like screenshots) for every transaction.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Design Principles","description":"The philosophy behind Guppy","href":"/design-principles","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Stateful by Default","slug":"stateful-by-default","depth":3,"children":[]},{"title":"Execution-Agnostic","slug":"execution-agnostic","depth":3,"children":[]},{"title":"Payment-Safe","slug":"payment-safe","depth":3,"children":[]},{"title":"Proof-First","slug":"proof-first","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"guppy","siteName":"Guppy","title":"Design Principles - Guppy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"design-principles.md"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The philosophy behind Guppy\">\u003cmeta data-mint-head name=\"application-name\" content=\"Guppy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Design Principles - Guppy\">\u003cmeta data-mint-head property=\"og:description\" content=\"The philosophy behind Guppy\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Guppy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.guppyapi.com/design-principles\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://guppy.mintlify.site/_mintlify/api/og/v2?division=Reliability\u0026amp;title=Design+Principles\u0026amp;description=The+philosophy+behind+Guppy\u0026amp;theme=9b52a9a70f7600b896a0b456\u0026amp;signature=10029080890bfb7b890a89103b870e3cfc95adde8c56608de889888f5b711b92\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Design Principles - Guppy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The philosophy behind Guppy\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://guppy.mintlify.site/_mintlify/api/og/v2?division=Reliability\u0026amp;title=Design+Principles\u0026amp;description=The+philosophy+behind+Guppy\u0026amp;theme=9b52a9a70f7600b896a0b456\u0026amp;signature=10029080890bfb7b890a89103b870e3cfc95adde8c56608de889888f5b711b92\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/guppy/qeiIedNmbZ2IwvT5/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Guppy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0b0b0c\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.guppyapi.com/design-principles\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/design-principles.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.guppyapi.com/#organization\",\"name\":\"Guppy\",\"url\":\"https://docs.guppyapi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/guppy/_rjB0PG4NviXv9wj/logo/icon.png?fit=max\u0026auto=format\u0026n=_rjB0PG4NviXv9wj\u0026q=85\u0026s=da5f85d4addc60777431aad28e12b865\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.guppyapi.com#website\",\"name\":\"Guppy\",\"url\":\"https://docs.guppyapi.com\",\"publisher\":{\"@id\":\"https://docs.guppyapi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.guppyapi.com/design-principles#webpage\",\"url\":\"https://docs.guppyapi.com/design-principles\",\"name\":\"Design Principles\",\"description\":\"The philosophy behind Guppy\",\"isPartOf\":{\"@id\":\"https://docs.guppyapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.guppyapi.com/design-principles#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.guppyapi.com/design-principles#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reliability\",\"item\":\"https://docs.guppyapi.com/error-model\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Design Principles\",\"item\":\"https://docs.guppyapi.com/design-principles\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.guppyapi.com/design-principles#article\",\"headline\":\"Design Principles\",\"name\":\"Design Principles\",\"description\":\"The philosophy behind Guppy\",\"url\":\"https://docs.guppyapi.com/design-principles\",\"mainEntityOfPage\":{\"@id\":\"https://docs.guppyapi.com/design-principles#webpage\"},\"publisher\":{\"@id\":\"https://docs.guppyapi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.guppyapi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Guppy\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Guppy\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/design-principles.md","siteName":"Guppy","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Authentication","href":"/authentication"},{"title":"Core Concepts","href":"/core-concepts"},{"title":"Examples","href":"/examples"}]},{"group":"Capabilities","pages":[{"title":"Use Cases","href":"/use-cases"}]},{"group":"Reliability","pages":[{"title":"Error Model","href":"/error-model"},{"title":"Idempotency","href":"/idempotency"},{"title":"Rate Limits","description":"API usage limits","href":"/rate-limits"},{"title":"Design Principles","href":"/design-principles"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]}]},"basePath":"","title":"Design Principles - Guppy","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}