How the MCP connector limits requests, and how to handle a 429.
The MCP connector limits how many requests it serves in a given window. There are two separate
allowances, and either one can be reached independently:
Per network address — counted before any agent is identified, so a flood from one address is
capped even before it authenticates.
Per connected agent — counted after the agent is identified, so several agents sharing a network
address don’t share this allowance, and one agent moving between addresses still has a single
budget.
Both are configured by Sumvin’s operators and can change without notice, so this page doesn’t publish
exact numbers — they aren’t fixed values you can rely on staying the same.
When you’re rate limited
A request over either allowance gets back an HTTP 429 with a Retry-After header, given in seconds.
Wait at least that long before trying again — retrying sooner gets the same refusal.
HTTP/1.1 429 Too Many RequestsRetry-After: 30
The two allowances carry different error codes so an agent can tell which one it hit — see
Errors for MCP-429-001-R and MCP-429-002-R.
A 429 on this connector is availability protection, not a judgement about the request. Back off for
the stated time and try again — there’s nothing else to change about the call itself.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sumvin","description":"Identity for every agent. Give your agent a verified identity, set the limits it acts within, and let it run errands for you.","colors":{"primary":"#1A6B3C","light":"#8BC540","dark":"#1A6B3C"},"logo":{"light":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/light.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=94c21eea5f2b742115618f128bafa28b","dark":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/dark.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=6cdf55e6a87e956d6d7fca6f5b65caa3","href":"/"},"favicon":"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/favicon.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=414a08a95872d9ecf8eaf56bf5176cc9","appearance":{"default":"light","strict":false},"background":{"color":{"light":"#F5F2EE","dark":"#0E1116"}},"navbar":{"primary":{"type":"button","label":"Connect your agent","href":"/get-started/connect"}},"seo":{"metatags":{"og:site_name":"Sumvin Docs","og:type":"website","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"heading":{"family":"Playfair Display","weight":500},"body":{"family":"DM Sans","weight":400}},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"vitesse-light","dark":"vitesse-dark"}},"latex":true},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","mcp","add-mcp"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"history","href":"/changelog"},{"anchor":"Get help","icon":"life-buoy","href":"mailto:hello@sumvin.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sumvin","hasAudioNarration":false,"actualSubdomain":"sumvin","customDomains":["docs.sumvin.com"],"gitSource":{"type":"github","owner":"sibylline-advisory","repo":"sumvin-api","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6acf382b2e3d8da06f635a9a","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Concepts","count":16},{"language":"default","tag":"SDK","count":14},{"language":"default","tag":"Reference","count":13},{"language":"default","tag":"Get started","count":12},{"language":"default","tag":"Stamped Mandates","count":7},{"language":"default","tag":"CLI","count":7},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"The nouns","count":5},{"language":"default","tag":"Everyday","count":5},{"language":"default","tag":"Check a mandate","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--gray-50: 245 242 238;--gray-100: 238 235 230;--gray-200: 225 221 214;--gray-300: 204 199 192;--gray-400: 158 154 148;--gray-500: 112 111 110;--gray-600: 80 82 87;--gray-700: 58 62 70;--gray-800: 36 40 48;--gray-900: 23 27 34;--gray-950: 14 17 22;--sv-ground: #f5f2ee;--sv-ink: #0a0a0a;--sv-muted: rgb(10 10 10 / 0.65);--sv-surface: #f0ede8;--sv-border: rgb(10 10 10 / 0.08);--sv-lime: #8bc540;--sv-forest: #1a6b3c;--sv-teal: #0d2e2b;--sv-danger: #e5412d;--sv-mono: \"JetBrains Mono\", ui-monospace, \"SFMono-Regular\", monospace;--sv-radius: 10px;--sv-radius-xl: 14px;--sv-radius-pill: 9999px;--sv-ease: cubic-bezier(0.16, 1, 0.3, 1)}.dark{--sv-ground: #0e1116;--sv-ink: #f5f2ee;--sv-muted: rgb(245 242 238 / 0.65);--sv-surface: #171b22;--sv-border: rgb(245 242 238 / 0.1);--sv-danger: #f97b73}code,pre,code-block,eyebrow{font-family:var(--sv-mono)}eyebrow{text-transform:uppercase;letter-spacing:0.08em;font-size:0.72rem;font-weight:500}#page-title,#content-area h1,#content-area h2,#content-area h3{font-weight:500;letter-spacing:-0.02em}#content-area h3{letter-spacing:-0.01em}mdx-content table,code{font-variant-numeric:tabular-nums}#navbar{background:color-mix(in oklch, var(--sv-ground) 82%, transparent);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border-bottom:1px solid var(--sv-border)}.nav-tabs-item[data-active]{color:var(--sv-ink)}html,body{background-color:var(--sv-ground)}#sidebar-content li[data-active]{font-weight:600}toc-item[data-active-deepest]{font-weight:600}#topbar-cta-button a>span:first-child{background:var(--sv-lime);border-radius:var(--sv-radius-pill);transition:background-color 0.3s var(--sv-ease)}#topbar-cta-button a,#topbar-cta-button a *{color:#0a0a0a}#topbar-cta-button a:hover>span:first-child{background:#0a0a0a;opacity:1}#topbar-cta-button a:hover,#topbar-cta-button a:hover *{color:var(--sv-lime)}card{border-radius:var(--sv-radius-xl);border-color:var(--sv-border);box-shadow:inset 0 1px 0 0 rgb(255 255 255 / 0.04);transition:border-color 0.4s var(--sv-ease)}card:hover{border-color:color-mix(in oklch, var(--sv-lime) 55%, transparent)}callout,[data-callout-type]{border-radius:var(--sv-radius)}[data-callout-type=\"note\"]{background:var(--sv-surface);border-color:var(--sv-border);border-left:3px solid var(--sv-forest)}[data-callout-type=\"note\"],[data-callout-type=\"note\"] *{color:var(--sv-ink)}[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"]{color:var(--sv-forest)}.dark [data-callout-type=\"note\"]{border-left-color:var(--sv-lime)}.dark [data-callout-type=\"note\"] [data-component-part=\"callout-icon\"]{color:var(--sv-lime)}code-block,code-group{border-radius:var(--sv-radius)}a:focus-visible,button:focus-visible,card:focus-visible,[tabindex]:focus-visible{outline:2px solid var(--sv-lime);outline-offset:2px}.sv-page{color:var(--sv-ink)}.sv-hero{background:var(--sv-teal);color:#f5f2ee}.sv-wrap{max-width:72rem;margin:0 auto;padding-left:clamp(1.25rem, 4vw, 3rem);padding-right:clamp(1.25rem, 4vw, 3rem)}.sv-eyebrow{font-family:var(--sv-mono);font-weight:500;text-transform:uppercase;letter-spacing:0.14em;font-size:0.75rem}.sv-hero .sv-eyebrow{color:var(--sv-lime)}.sv-display{font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-weight:500;font-size:clamp(2.75rem, 1.6rem + 4.6vw, 5.25rem);line-height:1.04;letter-spacing:-0.03em;max-width:14ch;margin:0}.sv-lede{font-size:clamp(1.05rem, 0.95rem + 0.4vw, 1.25rem);line-height:1.55;max-width:38rem;color:rgb(245 242 238 / 0.78)}.sv-muted{color:var(--sv-muted)}.sv-doors{display:grid;grid-template-columns:repeat(auto-fit, minmax(17rem, 1fr));gap:1rem;max-width:46rem}.sv-door{display:flex;flex-direction:column;gap:0.35rem;padding:1.25rem 1.4rem;border-radius:var(--sv-radius-xl);border:1px solid rgb(245 242 238 / 0.18);color:#f5f2ee;text-decoration:none;transition:background-color 0.3s var(--sv-ease), color 0.3s var(--sv-ease),\n border-color 0.3s var(--sv-ease)}.sv-door:hover{border-color:rgb(245 242 238 / 0.45)}.sv-door--primary{background:var(--sv-lime);border-color:var(--sv-lime);color:#0a0a0a}.sv-door--primary:hover{background:#0a0a0a;border-color:#0a0a0a;color:var(--sv-lime)}.sv-door-title{font-weight:600;font-size:1.05rem}.sv-door-meta{font-family:var(--sv-mono);font-size:0.78rem;opacity:0.8}.sv-journey{list-style:none;margin:0;padding:0;display:grid;grid-template-columns:repeat(auto-fit, minmax(10.5rem, 1fr));border-top:1px solid var(--sv-border)}.sv-station{padding:1.25rem 1.25rem 1.5rem 0}.sv-station a{display:flex;flex-direction:column;gap:0.4rem;color:var(--sv-ink);text-decoration:none}.sv-station-num{font-family:var(--sv-mono);font-size:0.75rem;letter-spacing:0.08em;color:var(--sv-muted)}.sv-station-name{font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-size:1.5rem;font-weight:500;line-height:1.2}.sv-station a:hover .sv-station-name{text-decoration:underline;text-decoration-color:var(--sv-lime);text-decoration-thickness:2px;text-underline-offset:6px}.sv-station-copy{font-size:0.925rem;line-height:1.5;color:var(--sv-muted);max-width:22ch}.sv-rule{border-top:1px solid var(--sv-border)}.sv-partners{display:flex;flex-wrap:wrap;gap:0.75rem 2.5rem;align-items:baseline}.sv-partner{color:var(--sv-ink);text-decoration:none;font-family:\"Playfair Display\", ui-serif, Georgia, serif;font-size:1.35rem;font-weight:500}.sv-partner:hover{text-decoration:underline;text-decoration-color:var(--sv-lime);text-underline-offset:5px}.sv-partner-role{display:block;font-family:var(--sv-mono);font-size:0.72rem;letter-spacing:0.06em;text-transform:uppercase;color:var(--sv-muted)}.sv-agent-line code{font-size:0.9em}.sv-agent-line a{color:var(--sv-ink);text-decoration-color:var(--sv-lime);text-underline-offset:4px}@keyframes sv-in{from{opacity:0;transform:translateY(8px) scale(0.98)}to{opacity:1;transform:none}}.sv-enter{animation:sv-in 0.5s var(--sv-ease) both}.sv-enter-2{animation:sv-in 0.5s var(--sv-ease) 90ms both}.sv-enter-3{animation:sv-in 0.5s var(--sv-ease) 180ms both}@media (prefers-reduced-motion: reduce){.sv-enter,.sv-enter-2,.sv-enter-3{animation:none}card,.sv-door{transition:none}}"}]}
{"page":{"pagePath":"reference/mcp/limits","slug":"/reference/mcp/limits","pageMetadata":{"title":"Rate limits","description":"How the MCP connector limits requests, and how to handle a 429.","icon":"gauge","href":"/reference/mcp/limits"},"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: \"How the MCP connector limits requests, and how to handle a 429.\"\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={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The MCP connector limits how many requests it serves in a given window. There are two separate\nallowances, and either one can be reached independently:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Per network address`}),` — counted before any agent is identified, so a flood from one address is\ncapped even before it authenticates.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Per connected agent`}),` — counted after the agent is identified, so several agents sharing a network\naddress don’t share this allowance, and one agent moving between addresses still has a single\nbudget.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Both are configured by Sumvin’s operators and can change without notice, so this page doesn’t publish\nexact numbers — they aren’t fixed values you can rely on staying the same.`}),`\n`,_jsx(Heading,{level:`2`,id:`when-you’re-rate-limited`,children:`When you’re rate limited`}),`\n`,_jsxs(_components.p,{children:[`A request over either allowance gets back an HTTP `,_jsx(_components.code,{children:`429`}),` with a `,_jsx(_components.code,{children:`Retry-After`}),` header, given in seconds.\nWait at least that long before trying again — retrying sooner gets the same refusal.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes vitesse-light vitesse-dark`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#121212`,color:`#393a34`,\"--shiki-dark\":`#dbd7caee`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`HTTP/1.1 429 Too Many Requests`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Retry-After: 30`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`The two allowances carry different error codes so an agent can tell which one it hit — see\n`,_jsx(_components.a,{href:`/reference/errors`,children:`Errors`}),` for `,_jsx(_components.code,{children:`MCP-429-001-R`}),` and `,_jsx(_components.code,{children:`MCP-429-002-R`}),`.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`429`}),` on this connector is availability protection, not a judgement about the request. Back off for\nthe stated time and try again — there’s nothing else to change about the call itself.`]})})]})}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":{"codeStyling":{"theme":{"light":"vitesse-light","dark":"vitesse-dark"}},"config":{},"pageMetadata":{"title":"Rate limits","description":"How the MCP connector limits requests, and how to handle a 429.","icon":"gauge","href":"/reference/mcp/limits"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"When you’re rate limited","slug":"when-you’re-rate-limited","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sumvin","siteName":"Sumvin","title":"Rate limits - Sumvin","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-23T18:27:54.117Z","originalFileLocation":"reference/mcp/limits.mdx"},"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=\"light\"}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=\"How the MCP connector limits requests, and how to handle a 429.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sumvin\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_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/sumvin/FEs-dgL48CXm4lte/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sumvin/FEs-dgL48CXm4lte/_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/sumvin/FEs-dgL48CXm4lte/_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/sumvin/FEs-dgL48CXm4lte/_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/sumvin/FEs-dgL48CXm4lte/_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/sumvin/FEs-dgL48CXm4lte/_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/sumvin/FEs-dgL48CXm4lte/_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/sumvin/FEs-dgL48CXm4lte/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Rate limits - Sumvin\">\u003cmeta data-mint-head property=\"og:description\" content=\"How the MCP connector limits requests, and how to handle a 429.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sumvin Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sumvin.com/reference/mcp/limits\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sumvin.mintlify.site/_mintlify/api/og/v2?division=MCP+server\u0026amp;title=Rate+limits\u0026amp;description=How+the+MCP+connector+limits+requests%2C+and+how+to+handle+a+429.\u0026amp;theme=3d88a2393dbf57d4e89837b2\u0026amp;signature=c0a46378c2e45f57703035f6825d0ca7a054d03f9b882157e14f961f152450fa\">\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=\"Rate limits - Sumvin\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How the MCP connector limits requests, and how to handle a 429.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sumvin.mintlify.site/_mintlify/api/og/v2?division=MCP+server\u0026amp;title=Rate+limits\u0026amp;description=How+the+MCP+connector+limits+requests%2C+and+how+to+handle+a+429.\u0026amp;theme=3d88a2393dbf57d4e89837b2\u0026amp;signature=c0a46378c2e45f57703035f6825d0ca7a054d03f9b882157e14f961f152450fa\">\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/sumvin/FEs-dgL48CXm4lte/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sumvin\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1A6B3C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sumvin.com/reference/mcp/limits\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/mcp/limits.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sumvin.com/#organization\",\"name\":\"Sumvin\",\"url\":\"https://docs.sumvin.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sumvin/iFVoZsDR9WS3r7Vw/logo/light.svg?fit=max\u0026auto=format\u0026n=iFVoZsDR9WS3r7Vw\u0026q=85\u0026s=94c21eea5f2b742115618f128bafa28b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sumvin.com#website\",\"name\":\"Sumvin\",\"url\":\"https://docs.sumvin.com\",\"publisher\":{\"@id\":\"https://docs.sumvin.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sumvin.com/reference/mcp/limits#webpage\",\"url\":\"https://docs.sumvin.com/reference/mcp/limits\",\"name\":\"Rate limits\",\"description\":\"How the MCP connector limits requests, and how to handle a 429.\",\"dateModified\":\"2026-09-23T18:27:54.117Z\",\"isPartOf\":{\"@id\":\"https://docs.sumvin.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sumvin.com/reference/mcp/limits#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sumvin.com/reference/mcp/limits#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"MCP server\",\"item\":\"https://docs.sumvin.com/reference/mcp/tools\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rate limits\",\"item\":\"https://docs.sumvin.com/reference/mcp/limits\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sumvin.com/reference/mcp/limits#article\",\"headline\":\"Rate limits\",\"name\":\"Rate limits\",\"description\":\"How the MCP connector limits requests, and how to handle a 429.\",\"url\":\"https://docs.sumvin.com/reference/mcp/limits\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sumvin.com/reference/mcp/limits#webpage\"},\"dateModified\":\"2026-09-23T18:27:54.117Z\",\"publisher\":{\"@id\":\"https://docs.sumvin.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sumvin.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sumvin\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sumvin\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/mcp/limits.md","siteName":"Sumvin","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"history","href":"/changelog"},{"anchor":"Get help","icon":"life-buoy","href":"mailto:hello@sumvin.com"}]},"tabs":[{"tab":"Get started","icon":"compass","pages":[{"title":"Get started","href":""}]},{"tab":"Concepts","icon":"book-open","pages":[{"title":"Concepts","href":"/concepts/sigil"}]},{"tab":"Guides","icon":"map","pages":[{"title":"Guides","href":"/guides/approve-or-decline"}]},{"tab":"Reference","icon":"square-terminal","groups":[{"group":"MCP server","pages":[{"title":"MCP tools","icon":"wrench","href":"/reference/mcp/tools"},{"title":"Refusals","description":"What it means when a connected agent's tool call is refused, and what to do next.","icon":"octagon-x","href":"/reference/mcp/refusals"},{"title":"Rate limits","icon":"gauge","href":"/reference/mcp/limits"}]},{"group":"CLI","pages":[{"title":"sumvin login, logout, whoami","description":"Sign in, sign out, and check your session from the terminal.","icon":"log-in","href":"/reference/cli/auth"},{"title":"sumvin kyc","icon":"id-card","href":"/reference/cli/kyc"},{"title":"sumvin sigil","icon":"badge-check","href":"/reference/cli/sigil"},{"title":"sumvin keys","icon":"key-round","href":"/reference/cli/keys"},{"title":"Stamped Mandates (sumvin pint)","icon":"shield-check","href":"/reference/cli/pint"},{"title":"sumvin errand","icon":"shopping-cart","href":"/reference/cli/errand"},{"title":"The --json contract","icon":"braces","href":"/reference/cli/json-output"}]},{"group":"Status and errors","pages":[{"title":"Errors","icon":"triangle-alert","href":"/reference/errors"},{"title":"Status labels","icon":"tag","href":"/reference/status-labels"},{"title":"Contact support","sidebarTitle":"Support","icon":"life-buoy","href":"/support"}]}]},{"tab":"SDK","icon":"package","pages":[{"title":"SDK","href":"/sdk/overview"}]}]},"basePath":"","title":"Rate limits - Sumvin","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}