Connect AI agents to Forecastable through the Integration MCP server.
The Forecastable Integration MCP server exposes the same partner Integration API as MCP tools. Use it from Cursor, Claude Desktop, or any client that supports the Model Context Protocol over Streamable HTTP.Each tool maps to an Integration REST endpoint. Tool inputs mirror the REST request shape: path parameters, query params, request data, and optional headers for organization context.
Prerequisites
Before connecting an MCP client, choose how the client authenticates:
OAuth (recommended for Cursor and Claude) — the client prompts you to sign in and approve scopes
API keys — static bearer tokens for clients that do not support MCP OAuth, scripts, and server-to-server tools
Both credential types use scopes to limit what the client can access. You can optionally set a default organization with X-Organization-Id on the MCP connection.
In Claude, open Customize in the sidebar, then go to Connectors.
Open Customize in Claude
Click the + button and choose Add custom connector.
Add a custom connector
2
Add the MCP server
In the Add custom connector dialog, set:
Field
Value
Name
Forecastable (or your preferred label)
URL
https://app.forecastable.com/mcp
Leave Advanced settings empty. Forecastable supports OAuth Dynamic Client Registration, so Claude registers an OAuth client automatically and receives a client ID and secret without showing them to you.
Configure the Forecastable connector
3
Authorize the connector
Open the Forecastable connector in Claude and click Connect.
Start the OAuth connection
Forecastable prompts you to sign in (if needed) and review the requested scopes on a consent screen. Click Allow to grant access. Claude exchanges the authorization code for an access token and uses it on later MCP requests.
4
Verify the connection
After authorization succeeds, test the connector in Claude. A good first check is to list organizations, choose one, and call a read-only tool such as listAccounts.Single-organization users can call account, contact, or plan tools immediately. If an organization is missing, the error lists accessible names and IDs; retry with params.organizationId.
Troubleshooting
Claude asks for a client ID and secret
Confirm you are using https://app.forecastable.com/mcp and that the Forecastable OAuth discovery endpoint is reachable at https://app.forecastable.com/.well-known/oauth-authorization-server. Claude should only require manual credentials if it cannot discover or call the dynamic registration endpoint.
Redirect URI mismatch
Claude dynamically registers https://claude.ai/api/mcp/auth_callback as its redirect URL. If you
created an OAuth app manually, confirm that callback URL is listed exactly in Redirect URLs.
Invalid client or unauthorized
Disconnect and reconnect the connector so Claude can register fresh OAuth credentials. If you
configured a client manually in Advanced settings, verify the client ID and client secret
match the Credentials section for the same OAuth app.
Insufficient scope
Disconnect and reconnect the connector so Claude can request the updated permissions and you can
approve them on the Forecastable consent screen.
Missing organization context
Your organization is selected automatically when you have access to exactly one. With multiple organizations, ask Claude to call listOrganizations and save your choice using setActiveOrganization.
Cursor discovers Forecastable’s OAuth metadata, registers a client automatically, and prompts you to authenticate. Sign in to Forecastable (if needed), review the consent screen, and click Allow.
Use an API key when your MCP client does not support OAuth. Add the server with an Authorization header:
Replace the placeholder with your API key. To set an optional default organization, add "X-Organization-Id": "YOUR_ORGANIZATION_ID" to headers.
Available tools
Tools are generated from the Integration OpenAPI specification. Each tool enforces the same scope and organization rules as the corresponding REST endpoint.
Meta
Tool
Description
Scopes
Organization required
getMeta
Integration API metadata (auth, scopes, pagination, rate limits)
none
no
Organizations
Tool
Description
Scopes
Organization required
listOrganizations
List organizations the API key can access
organizations:read
no
setActiveOrganization
Save the active organization for this user and token
organizations:read
yes
getActiveOrganization
Get the automatic default or saved organization
organizations:read
no
getOrganization
Get one organization by ID
organizations:read
yes
listOrganizationUsers
List users in an organization
users:read
yes
Accounts
Tool
Description
Scopes
Organization required
listAccounts
List accounts
accounts:read
yes
getAccount
Get one account
accounts:read
yes
createAccount
Create an account
accounts:write
yes
updateAccount
Update an account
accounts:write
yes
deleteAccount
Archive an account
accounts:archive
yes
bulkCreateAccounts
Create up to 200 accounts
accounts:write
yes
Contacts
Tool
Description
Scopes
Organization required
listAccountContacts
List contacts on an account
contacts:read
yes
getContact
Get one contact
contacts:read
yes
createAccountContact
Create a contact on an account
contacts:write
yes
updateContact
Update a contact
contacts:write
yes
deleteContact
Archive a contact
contacts:archive
yes
Opportunities
Tool
Description
Scopes
Organization required
listOpportunities
List opportunities
opportunities:read
yes
getOpportunity
Get one opportunity
opportunities:read
yes
createOpportunity
Create an opportunity
opportunities:write
yes
updateOpportunity
Update an opportunity
opportunities:write
yes
deleteOpportunity
Delete or archive an opportunity
opportunities:archive
yes
Leads
Tool
Description
Scopes
Organization required
listLeads
List leads
leads:read
yes
getLead
Get one lead
leads:read
yes
listAccountLeads
List leads for an account
leads:read
yes
createLead
Create a lead
leads:write
yes
upsertLead
Create or update a lead
leads:write
yes
updateLead
Update a lead
leads:write
yes
deleteLead
Archive a lead
leads:archive
yes
Relationship maps
Tool
Description
Scopes
Organization required
getRelationshipMapByEntity
Get the relationship map for an account/opportunity/group
relationship_maps:read
yes
getRelationshipMap
Get a relationship map by ID
relationship_maps:read
yes
upsertRelationshipMap
Create or replace a relationship map
relationship_maps:write
yes
updateRelationshipMap
Patch relationship map settings
relationship_maps:write
yes
upsertRelationshipMapContact
Create or update a contact on a relationship map
relationship_maps:write
yes
deleteRelationshipMapContact
Remove a contact from a relationship map
relationship_maps:write
yes
Plans
Tool
Description
Scopes
Organization required
listPlans
List partner plans
plans:read
yes
getPlan
Get one partner plan
plans:read
yes
createPlan
Create a partner plan
plans:write
yes
updatePlan
Update a partner plan
plans:write
yes
deletePlan
Archive a partner plan
plans:archive
yes
listPlanMilestones
List milestones on a plan
plan_items:read
yes
getPlanMilestone
Get one milestone
plan_items:read
yes
createPlanMilestone
Create a milestone
plan_items:write
yes
updatePlanMilestone
Update a milestone
plan_items:write
yes
deletePlanMilestone
Archive a milestone
plan_items:archive
yes
restorePlanMilestone
Restore an archived milestone
plan_items:archive
yes
listPlanGoals
List goals on a plan
plan_items:read
yes
createPlanGoal
Create a goal
plan_items:write
yes
updatePlanGoal
Update a goal
plan_items:write
yes
deletePlanGoal
Archive a goal
plan_items:archive
yes
listPlanTasks
List tasks on a plan
plan_items:read
yes
createPlanTask
Create a task
plan_items:write
yes
updatePlanTask
Update a task
plan_items:write
yes
deletePlanTask
Archive a task
plan_items:archive
yes
listMyTasks
List tasks assigned to the current user
plan_items:read
yes
Engage templates
Tool
Description
Scopes
Organization required
listEngageTemplates
List Engage templates
engage.templates:read
yes
getEngageTemplate
Get one Engage template
engage.templates:read
yes
createEngageTemplate
Create an Engage template
engage.templates:write
yes
updateEngageTemplate
Update an Engage template
engage.templates:write
yes
deleteEngageTemplate
Archive an Engage template
engage.templates:archive
yes
Engage drafts
Tool
Description
Scopes
Organization required
listEngageDrafts
List Engage drafts for a user
engage.queue:read
yes
getEngageDraft
Get one Engage draft
engage.queue:read
yes
createEngageDraft
Create an Engage draft
engage.campaigns:write
yes
updateEngageDraft
Update an Engage draft
engage.campaigns:write
yes
Engage lists
Tool
Description
Scopes
Organization required
listEngageLists
List Engage lists
engage.lists:read
yes
getEngageList
Get one Engage list
engage.lists:read
yes
listAccountEngageLists
List Engage lists targeting an account
engage.lists:read
yes
createEngageList
Create a manual or dynamic Engage list
engage.lists:write
yes
updateEngageList
Update an Engage list
engage.lists:write
yes
deleteEngageList
Archive an Engage list
engage.lists:archive
yes
listEngageListMembers
List list members (dynamic lists are derived)
engage.lists:read
yes
addEngageListMembers
Add members to a manual list
engage.lists:write
yes
updateEngageListMember
Update or link a manual list member
engage.lists:write
yes
removeEngageListMember
Remove a manual list member
engage.lists:write
yes
Engage campaigns
Tool
Description
Scopes
Organization required
listEngageCampaigns
List Engage campaign definitions
engage.campaigns:read
yes
getEngageCampaign
Get one campaign definition
engage.campaigns:read
yes
createEngageCampaign
Create a campaign definition (does not send). Wait steps support relative duration/unit or absolute scheduleMode=datetime + scheduledAt.
engage.campaigns:write
yes
bulkCreateEngageCampaigns
Create up to 25 campaigns with per-index results
engage.campaigns:write
yes
updateEngageCampaign
Update a campaign definition
engage.campaigns:write
yes
deleteEngageCampaign
Archive a campaign and deactivate live runs
engage.campaigns:archive
yes
getEngageCampaignStatus
Aggregate execution status for one campaign
engage.campaigns:read
yes
listEngageCampaignStatuses
Batch execution statuses (max 50 campaign IDs)
engage.campaigns:read
yes
getEngageEnrollment
Poll a campaign start (enrollment) job
engage.campaigns:read
yes
listEngageEnrollmentStatuses
Batch enrollment job statuses (max 50 job IDs)
engage.campaigns:read
yes
Engage queue (read-only)
Tool
Description
Scopes
Organization required
listEngageQueue
List outbound queue items across channels
engage.queue:read
yes
getEngageQueueItem
Get one queue item
engage.queue:read
yes
listEngageQueueRecipients
Per-recipient delivery and engagement for a send
engage.queue:read
yes
listEngageReplies
List inbound replies to Engage sends (email/Nylas; plain-text by default)
engage.replies:read
yes
getEngageReply
Get one inbound reply by provider message id
engage.replies:read
yes
Feed
Tool
Description
Scopes
Organization required
getAccountInbox
Account inbox: email threads, calendar events, and Slack messages
inbox:read
yes
getAccountInboxThreadMessages
Messages for an inbox email thread (plain-text by default; includeBodyHtml=true for HTML)
inbox:read
yes
getAccountInboxSlackThread
Messages in a Slack thread linked to the account
inbox:read
yes
getCommunicationAnalytics
Dashboard communication analytics (timeline + account rows); user-backed token
analytics:read
yes
listNeedsAttention
Accounts with unread email/Slack needing attention; user-backed token
feed:read
yes
Account inbox tools accept account UUIDs (not Relay global IDs). Thread ids may be a plain Nylas thread id or nylas:<grantId>:<threadId>. Clients should merge threads / events / slackMessages by timestamp when a single chronological list is needed. Dashboard tools (getCommunicationAnalytics, listNeedsAttention) require a user-backed token.
Calendar
Tool
Description
Scopes
Organization required
listCalendarEvents
List/search synced events (start/end required; filters: search, participantEmail, participantDomain, ownerUserId, hasExternalParticipant; order=desc for most recent)
calendar:read
yes
getCalendarEvent
Get one synced calendar event the authenticated user is authorized to view
calendar:read
yes
getCalendarEventSummary
Get the stored meeting summary for a previous calendar event
calls:read
yes
getCalendarEventActionItems
Get extracted action items for a previous calendar event
action_items:read
yes
getCalendarEventTranscript
Get the normalized transcript for a previous calendar event
transcripts:read
yes
updateCalendarEvent
Update a viewer-owned event (title, description, location, times, participants). For recurring events set recurrenceScope to this or all.
calendar:write
yes
Calendar tools require a user-backed token. Standard users see only their own events; admin and consulting users may also see authorized teammate events. Nested meeting tools return 404 when the event has no linked call recording. Updates apply only to viewer-owned events and push through the connected calendar provider.For “most recent meeting with X”, prefer listCalendarEvents with order=desc, a recent window, and search / participantDomain / participantEmail — do not page a wide ascending range and pick the first title match.
Tools marked as destructive (deleteAccount, deleteContact, deleteOpportunity,
deleteLead, deletePlan, deletePlanMilestone, deletePlanGoal, deletePlanTask,
deleteRelationshipMapContact, deleteEngageTemplate, deleteEngageList,
deleteEngageCampaign, removeEngageListMember) perform soft-delete or archive operations.
Confirm with your agent workflow before calling them.
Sending is REST-only.POST /engage/messages/send and
POST /engage/campaigns/{campaignId}/start are deliberately not exposed as MCP tools, so an
agent can prepare templates, drafts, lists, and campaigns but can never send messages or enroll
recipients through MCP. Outbound operations require the REST API with the engage.queue:send scope and
an Idempotency-Key header.
Authentication
Send your API key as a Bearer token on every authenticated MCP request:
Authorization: Bearer YOUR_API_KEY
Accepted credential types match the Integration REST API:
integration API keys issued from developer settings
OAuth2 authorization-code access tokens issued after user consent
OAuth2 client-credentials access tokens for server-to-server clients, where enabled
Revoked or expired API keys return 401 unauthorized.
Organization context
Most tools require an active organization. Provide it in one of these ways:
Saved selection: for multiple organizations, call listOrganizations, ask the user which to use, then call setActiveOrganization. The choice is stored for this user and token and survives reconnects and new chats.
Authentication resolves your current memberships within the token’s organization restrictions. When exactly one organization is accessible, it is the default on every call; setActiveOrganization is never needed. If you configure X-Organization-Id on the MCP connection, it acts as an optional default. Explicit tool headers or params override the automatic default or saved selection. If multiple explicit identifiers are supplied and they conflict, the server returns ambiguous_subscriber_context.Legacy header X-Subscriber-Id and query param subscriberId are still accepted.Optional header X-Request-Id is forwarded for tracing.
Sessions
The server uses MCP Streamable HTTP transport:
Method
Purpose
POST /mcp
Initialize a session or send JSON-RPC messages
GET /mcp
Open the SSE stream for an existing session
DELETE /mcp
Close a session
After the first POST, reuse the session by sending mcp-session-id on subsequent requests.
Example tool call
Single-organization users can call listPlans with {} immediately after connecting, including after a reconnect or in a new chat.For multiple organizations, first call listOrganizations:
{}
Ask the user which organization to use, then call setActiveOrganization to save their choice for this token:
{ "organizationId": "YOUR_ORGANIZATION_ID"}
After that, call organization-scoped tools without repeating the organization ID:
{ "params": { "limit": 25 }}
You can still pass xOrganizationId in a tool call or configure X-Organization-Id on the MCP server connection when you want an explicit default.
Scopes
MCP tools enforce the same scopes as the Integration REST API. Configure scopes on your API key or OAuth app before connecting.
Rate limits
MCP tool calls share the Integration API rate limits. When exceeded, the server returns 429 rate_limit_exceeded with a retryAfterSeconds hint.
Troubleshooting
401 unauthorized
Verify your API key is present, not expired, and not revoked. All tools except getMeta require authentication.
403 forbidden or insufficient scope
Check that your API key includes the scope required for the tool. For example, listAccounts
needs accounts:read.
Missing organization context
The error lists accessible organization names and IDs. Retry the failed call with
params.organizationId set to the chosen ID. For multiple organizations, use
setActiveOrganization to save your choice for later calls on this token. Single-organization
users receive an automatic default.
404 Integration MCP is disabled
The server returned not_found because MCP is disabled in that environment. Contact Forecastable
if you need MCP enabled.
Unknown MCP session
Ensure your client reuses mcp-session-id from the initialize response. Stale or missing session IDs return 400 validation_error.
Related resources
API reference — full Integration REST API documentation
GET /meta — live metadata for auth, scopes, and limits
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Forecastable","colors":{"primary":"#384785","light":"#6872b5","dark":"#384785"},"logo":{"light":"https://mintcdn.com/forecastable/J-L6BbuKUgRKPkJ6/logo/light.svg?fit=max\u0026auto=format\u0026n=J-L6BbuKUgRKPkJ6\u0026q=85\u0026s=97051fe9c8e5241a70951f7d01c99421","dark":"https://mintcdn.com/forecastable/J-L6BbuKUgRKPkJ6/logo/dark.svg?fit=max\u0026auto=format\u0026n=J-L6BbuKUgRKPkJ6\u0026q=85\u0026s=7e6416c77d36b3cc41f35a1605da90df"},"favicon":"https://mintcdn.com/forecastable/fU69crspsqRT-kfC/favicon.svg?fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=86344fe23848dac7922dae532fa7fbfd","navbar":{"links":[{"href":"mailto:support@forecastable.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.forecastable.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/forecastable"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Documentation","icon":"book-open-cover","href":"https://docs.forecastable.com"},{"anchor":"Blog","icon":"newspaper","href":"https://forecastable.com/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"forecastable","hasAudioNarration":false,"actualSubdomain":"forecastable","customDomains":["docs.forecastable.com"],"gitSource":{"type":"github","owner":"forecastable","repo":"forecastable-web","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afda935a93dec3133f7f2a2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":94},{"language":"default","tag":"Documentation","count":27},{"language":"default","tag":"Integrations","count":16},{"language":"default","tag":"Engage Campaigns","count":10},{"language":"default","tag":"Engage Lists","count":10},{"language":"default","tag":"Leads","count":7},{"language":"default","tag":"Accounts","count":6},{"language":"default","tag":"Calendar","count":6},{"language":"default","tag":"Milestones","count":6},{"language":"default","tag":"Relationship Maps","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"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":false},"customCss":[{"filePath":"custom.css","content":"#sidebar-content a[href=\"/developers/mcp\"]{column-gap:0.25rem}html.dark #sidebar-content a[href=\"/developers/mcp\"] img{filter:brightness(0) invert(1)}.mcp-install-buttons{display:flex;flex-wrap:wrap;gap:0.75rem;margin:1rem 0 1.25rem}.mcp-install-button{align-items:center;border:1px solid rgb(209 213 219);border-radius:0.75rem;color:rgb(31 41 55);display:inline-flex;font-weight:600;justify-content:center;line-height:1;padding:0.75rem 1rem;text-decoration:none;transition:background-color 150ms ease,\n border-color 150ms ease,\n color 150ms ease}.mcp-install-button:hover{background:rgb(249 250 251);border-color:rgb(156 163 175)}.mcp-install-button-primary{background:#384785;border-color:#384785;color:white}.mcp-install-button-primary:hover{background:#2f3a70;border-color:#2f3a70;color:white}html.dark .mcp-install-button{border-color:rgb(63 63 70);color:rgb(244 244 245)}html.dark .mcp-install-button:hover{background:rgb(39 39 42);border-color:rgb(82 82 91)}html.dark .mcp-install-button-primary{background:#6872b5;border-color:#6872b5;color:white}html.dark .mcp-install-button-primary:hover{background:#5963a8;border-color:#5963a8}"}]}
{"page":{"pagePath":"developers/mcp","slug":"/developers/mcp","pageMetadata":{"title":"MCP server","description":"Connect AI agents to Forecastable through the Integration MCP server.","icon":"/images/mcp.png","href":"/developers/mcp"},"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: \"Connect AI agents to Forecastable through the Integration MCP server.\"\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`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Tab,Table,Tabs,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Forecastable Integration MCP server`}),` exposes the same partner Integration API as MCP tools. Use it from Cursor, Claude Desktop, or any client that supports the `,_jsx(_components.a,{href:`https://modelcontextprotocol.io`,children:`Model Context Protocol`}),` over Streamable HTTP.`]}),`\n`,_jsxs(_components.p,{children:[`Each tool maps to an Integration REST endpoint. Tool inputs mirror the REST request shape: path parameters, query `,_jsx(_components.code,{children:`params`}),`, request `,_jsx(_components.code,{children:`data`}),`, and optional `,_jsx(_components.code,{children:`headers`}),` for organization context.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsx(_components.p,{children:`Before connecting an MCP client, choose how the client authenticates:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OAuth (recommended for Cursor and Claude)`}),` — the client prompts you to sign in and approve scopes`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/developers/api-keys`,children:`API keys`})}),` — static bearer tokens for clients that do not support MCP OAuth, scripts, and server-to-server tools`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Both credential types use `,_jsx(_components.a,{href:`/developers/scopes`,children:`scopes`}),` to limit what the client can access. You can optionally set a default organization with `,_jsx(_components.code,{children:`X-Organization-Id`}),` on the MCP connection.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-manually`,children:`Connect manually`}),`\n`,_jsxs(_components.p,{children:[`For guided client setup, see `,_jsx(_components.a,{href:`/integrations/chatgpt`,children:`ChatGPT`}),`, `,_jsx(_components.a,{href:`/integrations/claude`,children:`Claude’s Community connector`}),`, or `,_jsx(_components.a,{href:`/integrations/cursor`,children:`Cursor`}),`.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Claude Desktop`,id:`claude-desktop`,\"data-child-heading-ids\":`[\"troubleshooting\"]`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Remote MCP URL`})}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://app.forecastable.com/mcp`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Open connectors in Claude`,children:[_jsxs(_components.p,{children:[`In Claude, open `,_jsx(_components.strong,{children:`Customize`}),` in the sidebar, then go to `,_jsx(_components.strong,{children:`Connectors`}),`.`]}),_jsx(Frame,{caption:`Open Customize in Claude`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/select-customize.png?fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=534029922cab9970ef6b939c57d6050c`,alt:`Open Customize in Claude`,className:`mint-max-w-[960px]`,\"data-og-width\":`3350`,width:`3350`,\"data-og-height\":`2030`,height:`2030`,\"data-path\":`images/mcp/select-customize.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/select-customize.png?w=280\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=1098200f71935aeb4351cf0901ef5f83 280w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/select-customize.png?w=560\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=dae65b2037e8b45df31ba4ed79451a49 560w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/select-customize.png?w=840\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=bd5da031e4f34600e56a93663ce527d0 840w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/select-customize.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=52095a3aa853b3301911aca0e206d8e2 1100w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/select-customize.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=43fc519d3855052590946d72ebc6435e 1650w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/select-customize.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=c4968925df12c37bf5e757d8d043b849 2500w`})}),_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`+`}),` button and choose `,_jsx(_components.strong,{children:`Add custom connector`}),`.`]}),_jsx(Frame,{caption:`Add a custom connector`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-button.png?fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=9365e74461247dc0989921835a2d819e`,alt:`Add custom connector in Claude`,className:`mint-max-w-[960px]`,\"data-og-width\":`2940`,width:`2940`,\"data-og-height\":`2010`,height:`2010`,\"data-path\":`images/mcp/add-custom-connector-button.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-button.png?w=280\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=72b55e620e955821a44a238b0aa6f66a 280w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-button.png?w=560\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=d10dc54b745e51e7b19b4e552a72d045 560w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-button.png?w=840\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=b1f79737915fea85d47786dd7aadb66f 840w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-button.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=f77d36bd31b52610f2ceef1d7a943f36 1100w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-button.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=7112bc5f8c85db03be3a47b1459fc873 1650w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-button.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=d8cb497f578c77ff50b619372e6fe95d 2500w`})})]}),_jsxs(Step,{title:`Add the MCP server`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Add custom connector`}),` dialog, set:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Name`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`Forecastable`}),` (or your preferred label)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`URL`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://app.forecastable.com/mcp`})})]})]})]}),_jsxs(_components.p,{children:[`Leave `,_jsx(_components.strong,{children:`Advanced settings`}),` empty. Forecastable supports OAuth Dynamic Client Registration, so Claude registers an OAuth client automatically and receives a client ID and secret without showing them to you.`]}),_jsx(Frame,{caption:`Configure the Forecastable connector`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-dialog.png?fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=cf96d0fdbc77f848190f074671f8ea4a`,alt:`Add Forecastable MCP server in Claude`,className:`mint-max-w-[960px]`,\"data-og-width\":`1120`,width:`1120`,\"data-og-height\":`455`,height:`455`,\"data-path\":`images/mcp/add-custom-connector-dialog.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-dialog.png?w=280\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=b191cff09533764c797f24e3c8a7b73b 280w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-dialog.png?w=560\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=77293556dfd36bba6c4d807215922224 560w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-dialog.png?w=840\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=671d7aa2673e3660f1c807c1f778fc82 840w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-dialog.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=650532358d30954a07f433ebb213ef6b 1100w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-dialog.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=9d09873e00351add62897f86af6161af 1650w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/add-custom-connector-dialog.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=58ad4a889cb5cb2b3b4cdba9a0f81f56 2500w`})})]}),_jsxs(Step,{title:`Authorize the connector`,children:[_jsxs(_components.p,{children:[`Open the Forecastable connector in Claude and click `,_jsx(_components.strong,{children:`Connect`}),`.`]}),_jsx(Frame,{caption:`Start the OAuth connection`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/click-connect.png?fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=5997e4b103ea907a6090c407ed6485d2`,alt:`Connect to Forecastable in Claude`,\"data-og-width\":`712`,width:`712`,\"data-og-height\":`182`,height:`182`,\"data-path\":`images/mcp/click-connect.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/click-connect.png?w=280\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=176330f4e566de1bf188314187ba4031 280w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/click-connect.png?w=560\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=ae1c58cdbd0ac13c45f0fcb940ad64e1 560w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/click-connect.png?w=840\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=ee2cd8db1f028f42d95fb5f2fe7742a1 840w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/click-connect.png?w=1100\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=98da464bbaf15c255e349fcf8db13445 1100w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/click-connect.png?w=1650\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=3d04ee44b919604971976a973ff1fcf1 1650w, https://mintcdn.com/forecastable/fU69crspsqRT-kfC/images/mcp/click-connect.png?w=2500\u0026fit=max\u0026auto=format\u0026n=fU69crspsqRT-kfC\u0026q=85\u0026s=a45a72ee6e7991db201a7165ebd77694 2500w`})}),_jsxs(_components.p,{children:[`Forecastable prompts you to sign in (if needed) and review the requested scopes on a consent screen. Click `,_jsx(_components.strong,{children:`Allow`}),` to grant access. Claude exchanges the authorization code for an access token and uses it on later MCP requests.`]})]}),_jsxs(Step,{title:`Verify the connection`,children:[_jsxs(_components.p,{children:[`After authorization succeeds, test the connector in Claude. A good first check is to list organizations, choose one, and call a read-only tool such as `,_jsx(_components.code,{children:`listAccounts`}),`.`]}),_jsxs(_components.p,{children:[`Single-organization users can call account, contact, or plan tools immediately. If an organization is missing, the error lists accessible names and IDs; retry with `,_jsx(_components.code,{children:`params.organizationId`}),`.`]})]})]}),_jsx(Heading,{level:`3`,id:`troubleshooting`,children:`Troubleshooting`}),_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Claude asks for a client ID and secret`,id:`claude-asks-for-a-client-id-and-secret`,children:_jsxs(_components.p,{children:[`Confirm you are using `,_jsx(_components.code,{children:`https://app.forecastable.com/mcp`}),` and that the Forecastable OAuth discovery endpoint is reachable at `,_jsx(_components.code,{children:`https://app.forecastable.com/.well-known/oauth-authorization-server`}),`. Claude should only require manual credentials if it cannot discover or call the dynamic registration endpoint.`]})}),` `,_jsx(Accordion,{title:`Redirect URI mismatch`,id:`redirect-uri-mismatch`,children:_jsxs(_components.p,{children:[`Claude dynamically registers `,_jsx(_components.code,{children:`https://claude.ai/api/mcp/auth_callback`}),` as its redirect URL. If you\ncreated an OAuth app manually, confirm that callback URL is listed exactly in `,_jsx(_components.strong,{children:`Redirect URLs`}),`.`]})}),` `,_jsx(Accordion,{title:`Invalid client or unauthorized`,id:`invalid-client-or-unauthorized`,children:_jsxs(_components.p,{children:[`Disconnect and reconnect the connector so Claude can register fresh OAuth credentials. If you\nconfigured a client manually in `,_jsx(_components.strong,{children:`Advanced settings`}),`, verify the client ID and client secret\nmatch the `,_jsx(_components.strong,{children:`Credentials`}),` section for the same OAuth app.`]})}),` `,_jsx(Accordion,{title:`Insufficient scope`,id:`insufficient-scope`,children:_jsx(_components.p,{children:`Disconnect and reconnect the connector so Claude can request the updated permissions and you can\napprove them on the Forecastable consent screen.`})}),_jsx(Accordion,{title:`Missing organization context`,id:`missing-organization-context`,children:_jsxs(_components.p,{children:[`Your organization is selected automatically when you have access to exactly one. With multiple organizations, ask Claude to call `,_jsx(_components.code,{children:`listOrganizations`}),` and save your choice using `,_jsx(_components.code,{children:`setActiveOrganization`}),`.`]})})]})]}),_jsxs(Tab,{title:`Cursor`,id:`cursor`,children:[_jsx(`div`,{className:`mcp-install-buttons`,children:_jsx(`a`,{className:`mcp-install-button mcp-install-button-primary`,href:`cursor://anysphere.cursor-deeplink/mcp/install?name=forecastable\u0026config=eyJ1cmwiOiJodHRwczovL2FwcC5mb3JlY2FzdGFibGUuY29tL21jcCJ9`,children:_jsx(_components.p,{children:`Add to Cursor`})})}),_jsxs(_components.p,{children:[`Add a remote MCP server in your Cursor MCP configuration (`,_jsx(_components.code,{children:`.cursor/mcp.json`}),` or global MCP settings):`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcpServers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"forecastable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://app.forecastable.com/mcp\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Cursor discovers Forecastable’s OAuth metadata, registers a client automatically, and prompts you to authenticate. Sign in to Forecastable (if needed), review the consent screen, and click `,_jsx(_components.strong,{children:`Allow`}),`.`]})]}),_jsxs(Tab,{title:`API key`,id:`api-key`,children:[_jsxs(_components.p,{children:[`Use an API key when your MCP client does not support OAuth. Add the server with an `,_jsx(_components.code,{children:`Authorization`}),` header:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcpServers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"forecastable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://app.forecastable.com/mcp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer YOUR_API_KEY\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Replace the placeholder with your API key. To set an optional default organization, add `,_jsx(_components.code,{children:`\"X-Organization-Id\": \"YOUR_ORGANIZATION_ID\"`}),` to `,_jsx(_components.code,{children:`headers`}),`.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`available-tools`,children:`Available tools`}),`\n`,_jsx(_components.p,{children:`Tools are generated from the Integration OpenAPI specification. Each tool enforces the same scope and organization rules as the corresponding REST endpoint.`}),`\n`,_jsx(Heading,{level:`3`,id:`meta`,children:`Meta`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getMeta`})}),_jsx(_components.td,{children:`Integration API metadata (auth, scopes, pagination, rate limits)`}),_jsx(_components.td,{children:`none`}),_jsx(_components.td,{children:`no`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`organizations`,children:`Organizations`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listOrganizations`})}),_jsx(_components.td,{children:`List organizations the API key can access`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`organizations:read`})}),_jsx(_components.td,{children:`no`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`setActiveOrganization`})}),_jsx(_components.td,{children:`Save the active organization for this user and token`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`organizations:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getActiveOrganization`})}),_jsx(_components.td,{children:`Get the automatic default or saved organization`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`organizations:read`})}),_jsx(_components.td,{children:`no`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getOrganization`})}),_jsx(_components.td,{children:`Get one organization by ID`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`organizations:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listOrganizationUsers`})}),_jsx(_components.td,{children:`List users in an organization`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`users:read`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`accounts`,children:`Accounts`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listAccounts`})}),_jsx(_components.td,{children:`List accounts`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`accounts:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getAccount`})}),_jsx(_components.td,{children:`Get one account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`accounts:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createAccount`})}),_jsx(_components.td,{children:`Create an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`accounts:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateAccount`})}),_jsx(_components.td,{children:`Update an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`accounts:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteAccount`})}),_jsx(_components.td,{children:`Archive an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`accounts:archive`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bulkCreateAccounts`})}),_jsx(_components.td,{children:`Create up to 200 accounts`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`accounts:write`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`contacts`,children:`Contacts`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listAccountContacts`})}),_jsx(_components.td,{children:`List contacts on an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contacts:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getContact`})}),_jsx(_components.td,{children:`Get one contact`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contacts:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createAccountContact`})}),_jsx(_components.td,{children:`Create a contact on an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contacts:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateContact`})}),_jsx(_components.td,{children:`Update a contact`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contacts:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteContact`})}),_jsx(_components.td,{children:`Archive a contact`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contacts:archive`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`opportunities`,children:`Opportunities`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listOpportunities`})}),_jsx(_components.td,{children:`List opportunities`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`opportunities:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getOpportunity`})}),_jsx(_components.td,{children:`Get one opportunity`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`opportunities:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createOpportunity`})}),_jsx(_components.td,{children:`Create an opportunity`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`opportunities:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateOpportunity`})}),_jsx(_components.td,{children:`Update an opportunity`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`opportunities:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteOpportunity`})}),_jsx(_components.td,{children:`Delete or archive an opportunity`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`opportunities:archive`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`leads`,children:`Leads`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listLeads`})}),_jsx(_components.td,{children:`List leads`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`leads:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getLead`})}),_jsx(_components.td,{children:`Get one lead`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`leads:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listAccountLeads`})}),_jsx(_components.td,{children:`List leads for an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`leads:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createLead`})}),_jsx(_components.td,{children:`Create a lead`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`leads:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`upsertLead`})}),_jsx(_components.td,{children:`Create or update a lead`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`leads:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateLead`})}),_jsx(_components.td,{children:`Update a lead`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`leads:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteLead`})}),_jsx(_components.td,{children:`Archive a lead`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`leads:archive`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`relationship-maps`,children:`Relationship maps`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getRelationshipMapByEntity`})}),_jsx(_components.td,{children:`Get the relationship map for an account/opportunity/group`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`relationship_maps:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getRelationshipMap`})}),_jsx(_components.td,{children:`Get a relationship map by ID`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`relationship_maps:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`upsertRelationshipMap`})}),_jsx(_components.td,{children:`Create or replace a relationship map`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`relationship_maps:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateRelationshipMap`})}),_jsx(_components.td,{children:`Patch relationship map settings`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`relationship_maps:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`upsertRelationshipMapContact`})}),_jsx(_components.td,{children:`Create or update a contact on a relationship map`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`relationship_maps:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteRelationshipMapContact`})}),_jsx(_components.td,{children:`Remove a contact from a relationship map`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`relationship_maps:write`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`plans`,children:`Plans`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listPlans`})}),_jsx(_components.td,{children:`List partner plans`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plans:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getPlan`})}),_jsx(_components.td,{children:`Get one partner plan`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plans:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createPlan`})}),_jsx(_components.td,{children:`Create a partner plan`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plans:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updatePlan`})}),_jsx(_components.td,{children:`Update a partner plan`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plans:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deletePlan`})}),_jsx(_components.td,{children:`Archive a partner plan`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plans:archive`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listPlanMilestones`})}),_jsx(_components.td,{children:`List milestones on a plan`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getPlanMilestone`})}),_jsx(_components.td,{children:`Get one milestone`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createPlanMilestone`})}),_jsx(_components.td,{children:`Create a milestone`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updatePlanMilestone`})}),_jsx(_components.td,{children:`Update a milestone`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deletePlanMilestone`})}),_jsx(_components.td,{children:`Archive a milestone`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:archive`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`restorePlanMilestone`})}),_jsx(_components.td,{children:`Restore an archived milestone`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:archive`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listPlanGoals`})}),_jsx(_components.td,{children:`List goals on a plan`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createPlanGoal`})}),_jsx(_components.td,{children:`Create a goal`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updatePlanGoal`})}),_jsx(_components.td,{children:`Update a goal`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deletePlanGoal`})}),_jsx(_components.td,{children:`Archive a goal`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:archive`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listPlanTasks`})}),_jsx(_components.td,{children:`List tasks on a plan`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createPlanTask`})}),_jsx(_components.td,{children:`Create a task`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updatePlanTask`})}),_jsx(_components.td,{children:`Update a task`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deletePlanTask`})}),_jsx(_components.td,{children:`Archive a task`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:archive`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listMyTasks`})}),_jsx(_components.td,{children:`List tasks assigned to the current user`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`plan_items:read`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`engage-templates`,children:`Engage templates`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageTemplates`})}),_jsx(_components.td,{children:`List Engage templates`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.templates:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getEngageTemplate`})}),_jsx(_components.td,{children:`Get one Engage template`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.templates:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createEngageTemplate`})}),_jsx(_components.td,{children:`Create an Engage template`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.templates:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateEngageTemplate`})}),_jsx(_components.td,{children:`Update an Engage template`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.templates:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteEngageTemplate`})}),_jsx(_components.td,{children:`Archive an Engage template`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.templates:archive`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`engage-drafts`,children:`Engage drafts`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageDrafts`})}),_jsx(_components.td,{children:`List Engage drafts for a user`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.queue:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getEngageDraft`})}),_jsx(_components.td,{children:`Get one Engage draft`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.queue:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createEngageDraft`})}),_jsx(_components.td,{children:`Create an Engage draft`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateEngageDraft`})}),_jsx(_components.td,{children:`Update an Engage draft`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:write`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`engage-lists`,children:`Engage lists`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageLists`})}),_jsx(_components.td,{children:`List Engage lists`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getEngageList`})}),_jsx(_components.td,{children:`Get one Engage list`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listAccountEngageLists`})}),_jsx(_components.td,{children:`List Engage lists targeting an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createEngageList`})}),_jsx(_components.td,{children:`Create a manual or dynamic Engage list`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateEngageList`})}),_jsx(_components.td,{children:`Update an Engage list`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteEngageList`})}),_jsx(_components.td,{children:`Archive an Engage list`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:archive`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageListMembers`})}),_jsx(_components.td,{children:`List list members (dynamic lists are derived)`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`addEngageListMembers`})}),_jsx(_components.td,{children:`Add members to a manual list`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateEngageListMember`})}),_jsx(_components.td,{children:`Update or link a manual list member`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`removeEngageListMember`})}),_jsx(_components.td,{children:`Remove a manual list member`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.lists:write`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`engage-campaigns`,children:`Engage campaigns`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageCampaigns`})}),_jsx(_components.td,{children:`List Engage campaign definitions`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getEngageCampaign`})}),_jsx(_components.td,{children:`Get one campaign definition`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`createEngageCampaign`})}),_jsxs(_components.td,{children:[`Create a campaign definition (does not send). Wait steps support relative `,_jsx(_components.code,{children:`duration`}),`/`,_jsx(_components.code,{children:`unit`}),` or absolute `,_jsx(_components.code,{children:`scheduleMode=datetime`}),` + `,_jsx(_components.code,{children:`scheduledAt`}),`.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bulkCreateEngageCampaigns`})}),_jsx(_components.td,{children:`Create up to 25 campaigns with per-index results`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateEngageCampaign`})}),_jsx(_components.td,{children:`Update a campaign definition`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:write`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteEngageCampaign`})}),_jsx(_components.td,{children:`Archive a campaign and deactivate live runs`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:archive`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getEngageCampaignStatus`})}),_jsx(_components.td,{children:`Aggregate execution status for one campaign`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageCampaignStatuses`})}),_jsx(_components.td,{children:`Batch execution statuses (max 50 campaign IDs)`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getEngageEnrollment`})}),_jsx(_components.td,{children:`Poll a campaign start (enrollment) job`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageEnrollmentStatuses`})}),_jsx(_components.td,{children:`Batch enrollment job statuses (max 50 job IDs)`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.campaigns:read`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`engage-queue-read-only`,children:`Engage queue (read-only)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageQueue`})}),_jsx(_components.td,{children:`List outbound queue items across channels`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.queue:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getEngageQueueItem`})}),_jsx(_components.td,{children:`Get one queue item`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.queue:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageQueueRecipients`})}),_jsx(_components.td,{children:`Per-recipient delivery and engagement for a send`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.queue:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listEngageReplies`})}),_jsx(_components.td,{children:`List inbound replies to Engage sends (email/Nylas; plain-text by default)`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.replies:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getEngageReply`})}),_jsx(_components.td,{children:`Get one inbound reply by provider message id`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`engage.replies:read`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`feed`,children:`Feed`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getAccountInbox`})}),_jsx(_components.td,{children:`Account inbox: email threads, calendar events, and Slack messages`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`inbox:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getAccountInboxThreadMessages`})}),_jsxs(_components.td,{children:[`Messages for an inbox email thread (plain-text by default; `,_jsx(_components.code,{children:`includeBodyHtml=true`}),` for HTML)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`inbox:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getAccountInboxSlackThread`})}),_jsx(_components.td,{children:`Messages in a Slack thread linked to the account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`inbox:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getCommunicationAnalytics`})}),_jsx(_components.td,{children:`Dashboard communication analytics (timeline + account rows); user-backed token`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`analytics:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listNeedsAttention`})}),_jsx(_components.td,{children:`Accounts with unread email/Slack needing attention; user-backed token`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`feed:read`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Account inbox tools accept account UUIDs (not Relay global IDs). Thread ids may be a plain Nylas thread id or `,_jsx(_components.code,{children:`nylas:\u003cgrantId>:\u003cthreadId>`}),`. Clients should merge `,_jsx(_components.code,{children:`threads`}),` / `,_jsx(_components.code,{children:`events`}),` / `,_jsx(_components.code,{children:`slackMessages`}),` by timestamp when a single chronological list is needed. Dashboard tools (`,_jsx(_components.code,{children:`getCommunicationAnalytics`}),`, `,_jsx(_components.code,{children:`listNeedsAttention`}),`) require a `,_jsx(_components.strong,{children:`user-backed`}),` token.`]}),`\n`,_jsx(Heading,{level:`3`,id:`calendar`,children:`Calendar`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tool`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Scopes`}),_jsx(_components.th,{children:`Organization required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`listCalendarEvents`})}),_jsxs(_components.td,{children:[`List/search synced events (`,_jsx(_components.code,{children:`start`}),`/`,_jsx(_components.code,{children:`end`}),` required; filters: `,_jsx(_components.code,{children:`search`}),`, `,_jsx(_components.code,{children:`participantEmail`}),`, `,_jsx(_components.code,{children:`participantDomain`}),`, `,_jsx(_components.code,{children:`ownerUserId`}),`, `,_jsx(_components.code,{children:`hasExternalParticipant`}),`; `,_jsx(_components.code,{children:`order=desc`}),` for most recent)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`calendar:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getCalendarEvent`})}),_jsx(_components.td,{children:`Get one synced calendar event the authenticated user is authorized to view`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`calendar:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getCalendarEventSummary`})}),_jsx(_components.td,{children:`Get the stored meeting summary for a previous calendar event`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`calls:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getCalendarEventActionItems`})}),_jsx(_components.td,{children:`Get extracted action items for a previous calendar event`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`action_items:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`getCalendarEventTranscript`})}),_jsx(_components.td,{children:`Get the normalized transcript for a previous calendar event`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`transcripts:read`})}),_jsx(_components.td,{children:`yes`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`updateCalendarEvent`})}),_jsxs(_components.td,{children:[`Update a viewer-owned event (title, description, location, times, participants). For recurring events set `,_jsx(_components.code,{children:`recurrenceScope`}),` to `,_jsx(_components.code,{children:`this`}),` or `,_jsx(_components.code,{children:`all`}),`.`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`calendar:write`})}),_jsx(_components.td,{children:`yes`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Calendar tools require a `,_jsx(_components.strong,{children:`user-backed`}),` token. Standard users see only their own events; admin and consulting users may also see authorized teammate events. Nested meeting tools return `,_jsx(_components.code,{children:`404`}),` when the event has no linked call recording. Updates apply only to viewer-owned events and push through the connected calendar provider.`]}),`\n`,_jsxs(_components.p,{children:[`For “most recent meeting with X”, prefer `,_jsx(_components.code,{children:`listCalendarEvents`}),` with `,_jsx(_components.code,{children:`order=desc`}),`, a recent window, and `,_jsx(_components.code,{children:`search`}),` / `,_jsx(_components.code,{children:`participantDomain`}),` / `,_jsx(_components.code,{children:`participantEmail`}),` — do not page a wide ascending range and pick the first title match.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Tools marked as destructive (`,_jsx(_components.code,{children:`deleteAccount`}),`, `,_jsx(_components.code,{children:`deleteContact`}),`, `,_jsx(_components.code,{children:`deleteOpportunity`}),`,\n`,_jsx(_components.code,{children:`deleteLead`}),`, `,_jsx(_components.code,{children:`deletePlan`}),`, `,_jsx(_components.code,{children:`deletePlanMilestone`}),`, `,_jsx(_components.code,{children:`deletePlanGoal`}),`, `,_jsx(_components.code,{children:`deletePlanTask`}),`,\n`,_jsx(_components.code,{children:`deleteRelationshipMapContact`}),`, `,_jsx(_components.code,{children:`deleteEngageTemplate`}),`, `,_jsx(_components.code,{children:`deleteEngageList`}),`,\n`,_jsx(_components.code,{children:`deleteEngageCampaign`}),`, `,_jsx(_components.code,{children:`removeEngageListMember`}),`) perform soft-delete or archive operations.\nConfirm with your agent workflow before calling them.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Sending is REST-only.`}),` `,_jsx(_components.code,{children:`POST /engage/messages/send`}),` and\n`,_jsx(_components.code,{children:`POST /engage/campaigns/{campaignId}/start`}),` are deliberately not exposed as MCP tools, so an\nagent can prepare templates, drafts, lists, and campaigns but can never send messages or enroll\nrecipients through MCP. Outbound operations require the REST API with the `,_jsx(_components.code,{children:`engage.queue:send`}),` scope and\nan `,_jsx(_components.code,{children:`Idempotency-Key`}),` header.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsx(_components.p,{children:`Send your API key as a Bearer token on every authenticated MCP request:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer YOUR_API_KEY`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Accepted credential types match the Integration REST API:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`integration API keys issued from developer settings`}),`\n`,_jsx(_components.li,{children:`OAuth2 authorization-code access tokens issued after user consent`}),`\n`,_jsx(_components.li,{children:`OAuth2 client-credentials access tokens for server-to-server clients, where enabled`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Revoked or expired API keys return `,_jsx(_components.code,{children:`401 unauthorized`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`organization-context`,children:`Organization context`}),`\n`,_jsx(_components.p,{children:`Most tools require an active organization. Provide it in one of these ways:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Request header (recommended):`}),` `,_jsx(_components.code,{children:`X-Organization-Id: \u003cuuid>`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tool input headers:`}),` `,_jsx(_components.code,{children:`{ \"headers\": { \"xOrganizationId\": \"\u003cuuid>\" } }`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Query params in tool input:`}),` `,_jsx(_components.code,{children:`{ \"params\": { \"organizationId\": \"\u003cuuid>\" } }`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Saved selection:`}),` for multiple organizations, call `,_jsx(_components.code,{children:`listOrganizations`}),`, ask the user which to use, then call `,_jsx(_components.code,{children:`setActiveOrganization`}),`. The choice is stored for this user and token and survives reconnects and new chats.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Authentication resolves your current memberships within the token’s organization restrictions. When exactly one organization is accessible, it is the default on every call; `,_jsx(_components.code,{children:`setActiveOrganization`}),` is never needed. If you configure `,_jsx(_components.code,{children:`X-Organization-Id`}),` on the MCP connection, it acts as an optional default. Explicit tool headers or params override the automatic default or saved selection. If multiple explicit identifiers are supplied and they conflict, the server returns `,_jsx(_components.code,{children:`ambiguous_subscriber_context`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Legacy header `,_jsx(_components.code,{children:`X-Subscriber-Id`}),` and query param `,_jsx(_components.code,{children:`subscriberId`}),` are still accepted.`]}),`\n`,_jsxs(_components.p,{children:[`Optional header `,_jsx(_components.code,{children:`X-Request-Id`}),` is forwarded for tracing.`]}),`\n`,_jsx(Heading,{level:`2`,id:`sessions`,children:`Sessions`}),`\n`,_jsxs(_components.p,{children:[`The server uses MCP `,_jsx(_components.strong,{children:`Streamable HTTP`}),` transport:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Purpose`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /mcp`})}),_jsx(_components.td,{children:`Initialize a session or send JSON-RPC messages`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /mcp`})}),_jsx(_components.td,{children:`Open the SSE stream for an existing session`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DELETE /mcp`})}),_jsx(_components.td,{children:`Close a session`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`After the first `,_jsx(_components.code,{children:`POST`}),`, reuse the session by sending `,_jsx(_components.code,{children:`mcp-session-id`}),` on subsequent requests.`]}),`\n`,_jsx(Heading,{level:`2`,id:`example-tool-call`,children:`Example tool call`}),`\n`,_jsxs(_components.p,{children:[`Single-organization users can call `,_jsx(_components.code,{children:`listPlans`}),` with `,_jsx(_components.code,{children:`{}`}),` immediately after connecting, including after a reconnect or in a new chat.`]}),`\n`,_jsxs(_components.p,{children:[`For multiple organizations, first call `,_jsx(_components.code,{children:`listOrganizations`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Ask the user which organization to use, then call `,_jsx(_components.code,{children:`setActiveOrganization`}),` to save their choice for this token:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"organizationId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_ORGANIZATION_ID\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`After that, call organization-scoped tools without repeating the organization ID:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"params\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"limit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`25`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`You can still pass `,_jsx(_components.code,{children:`xOrganizationId`}),` in a tool call or configure `,_jsx(_components.code,{children:`X-Organization-Id`}),` on the MCP server connection when you want an explicit default.`]}),`\n`,_jsx(Heading,{level:`2`,id:`scopes`,children:`Scopes`}),`\n`,_jsxs(_components.p,{children:[`MCP tools enforce the same `,_jsx(_components.a,{href:`/developers/scopes`,children:`scopes`}),` as the Integration REST API. Configure scopes on your API key or OAuth app before connecting.`]}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limits`,children:`Rate limits`}),`\n`,_jsxs(_components.p,{children:[`MCP tool calls share the Integration API `,_jsx(_components.a,{href:`/developers/rate-limits`,children:`rate limits`}),`. When exceeded, the server returns `,_jsx(_components.code,{children:`429 rate_limit_exceeded`}),` with a `,_jsx(_components.code,{children:`retryAfterSeconds`}),` hint.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting-2`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`401 unauthorized`,id:`401-unauthorized`,children:_jsxs(_components.p,{children:[`Verify your API key is present, not expired, and not revoked. All tools except `,_jsx(_components.code,{children:`getMeta`}),` require authentication.`]})}),` `,_jsx(Accordion,{title:`403 forbidden or insufficient scope`,id:`403-forbidden-or-insufficient-scope`,children:_jsxs(_components.p,{children:[`Check that your API key includes the scope required for the tool. For example, `,_jsx(_components.code,{children:`listAccounts`}),`\nneeds `,_jsx(_components.code,{children:`accounts:read`}),`.`]})}),` `,_jsx(Accordion,{title:`Missing organization context`,id:`missing-organization-context-1`,children:_jsxs(_components.p,{children:[`The error lists accessible organization names and IDs. Retry the failed call with\n`,_jsx(_components.code,{children:`params.organizationId`}),` set to the chosen ID. For multiple organizations, use\n`,_jsx(_components.code,{children:`setActiveOrganization`}),` to save your choice for later calls on this token. Single-organization\nusers receive an automatic default.`]})}),` `,_jsx(Accordion,{title:`404 Integration MCP is disabled`,id:`404-integration-mcp-is-disabled`,children:_jsxs(_components.p,{children:[`The server returned `,_jsx(_components.code,{children:`not_found`}),` because MCP is disabled in that environment. Contact Forecastable\nif you need MCP enabled.`]})}),_jsx(Accordion,{title:`Unknown MCP session`,id:`unknown-mcp-session`,children:_jsxs(_components.p,{children:[`Ensure your client reuses `,_jsx(_components.code,{children:`mcp-session-id`}),` from the initialize response. Stale or missing session IDs return `,_jsx(_components.code,{children:`400 validation_error`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-resources`,children:`Related resources`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/meta/get-integration-api-metadata`,children:`API reference`}),` — full Integration REST API documentation`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/meta/get-integration-api-metadata`,children:`GET /meta`}),` — live metadata for auth, scopes, and limits`]}),`\n`]})]})}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":"MCP server","description":"Connect AI agents to Forecastable through the Integration MCP server.","icon":"/images/mcp.png","href":"/developers/mcp"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Connect manually","slug":"connect-manually","depth":2,"children":[{"title":"Troubleshooting","slug":"troubleshooting","depth":3,"children":[],"tabId":"claude-desktop"}]},{"title":"Available tools","slug":"available-tools","depth":2,"children":[{"title":"Meta","slug":"meta","depth":3,"children":[]},{"title":"Organizations","slug":"organizations","depth":3,"children":[]},{"title":"Accounts","slug":"accounts","depth":3,"children":[]},{"title":"Contacts","slug":"contacts","depth":3,"children":[]},{"title":"Opportunities","slug":"opportunities","depth":3,"children":[]},{"title":"Leads","slug":"leads","depth":3,"children":[]},{"title":"Relationship maps","slug":"relationship-maps","depth":3,"children":[]},{"title":"Plans","slug":"plans","depth":3,"children":[]},{"title":"Engage templates","slug":"engage-templates","depth":3,"children":[]},{"title":"Engage drafts","slug":"engage-drafts","depth":3,"children":[]},{"title":"Engage lists","slug":"engage-lists","depth":3,"children":[]},{"title":"Engage campaigns","slug":"engage-campaigns","depth":3,"children":[]},{"title":"Engage queue (read-only)","slug":"engage-queue-read-only","depth":3,"children":[]},{"title":"Feed","slug":"feed","depth":3,"children":[]},{"title":"Calendar","slug":"calendar","depth":3,"children":[]}]},{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Organization context","slug":"organization-context","depth":2,"children":[]},{"title":"Sessions","slug":"sessions","depth":2,"children":[]},{"title":"Example tool call","slug":"example-tool-call","depth":2,"children":[]},{"title":"Scopes","slug":"scopes","depth":2,"children":[]},{"title":"Rate limits","slug":"rate-limits","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting-2","depth":2,"children":[]},{"title":"Related resources","slug":"related-resources","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-max-w-\\[960px\\] {\n max-width: 960px\n}","subdomain":"forecastable","siteName":"Forecastable","title":"MCP server - Forecastable","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T13:33:53.950Z","originalFileLocation":"developers/mcp.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=\"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=\"Connect AI agents to Forecastable through the Integration MCP server.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Forecastable\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/forecastable/5Nzqrl1GGkw3xwmw/_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/forecastable/5Nzqrl1GGkw3xwmw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/forecastable/5Nzqrl1GGkw3xwmw/_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/forecastable/5Nzqrl1GGkw3xwmw/_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/forecastable/5Nzqrl1GGkw3xwmw/_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/forecastable/5Nzqrl1GGkw3xwmw/_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/forecastable/5Nzqrl1GGkw3xwmw/_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/forecastable/5Nzqrl1GGkw3xwmw/_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/forecastable/5Nzqrl1GGkw3xwmw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"MCP server - Forecastable\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect AI agents to Forecastable through the Integration MCP server.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Forecastable\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.forecastable.com/developers/mcp\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://forecastable.mintlify.site/_mintlify/api/og/v2?division=AI\u0026amp;title=MCP+server\u0026amp;description=Connect+AI+agents+to+Forecastable+through+the+Integration+MCP+server.\u0026amp;theme=741b6bf419ef2b2dd1603c34\u0026amp;signature=977337beb8af1b10891ed86e82c5e3c4f89ec0095eabf5205992c93668c7977e\">\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=\"MCP server - Forecastable\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect AI agents to Forecastable through the Integration MCP server.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://forecastable.mintlify.site/_mintlify/api/og/v2?division=AI\u0026amp;title=MCP+server\u0026amp;description=Connect+AI+agents+to+Forecastable+through+the+Integration+MCP+server.\u0026amp;theme=741b6bf419ef2b2dd1603c34\u0026amp;signature=977337beb8af1b10891ed86e82c5e3c4f89ec0095eabf5205992c93668c7977e\">\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/forecastable/5Nzqrl1GGkw3xwmw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Forecastable\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#384785\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.forecastable.com/developers/mcp\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/mcp.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.forecastable.com/#organization\",\"name\":\"Forecastable\",\"url\":\"https://docs.forecastable.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/forecastable/J-L6BbuKUgRKPkJ6/logo/light.svg?fit=max\u0026auto=format\u0026n=J-L6BbuKUgRKPkJ6\u0026q=85\u0026s=97051fe9c8e5241a70951f7d01c99421\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.forecastable.com#website\",\"name\":\"Forecastable\",\"url\":\"https://docs.forecastable.com\",\"publisher\":{\"@id\":\"https://docs.forecastable.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.forecastable.com/developers/mcp#webpage\",\"url\":\"https://docs.forecastable.com/developers/mcp\",\"name\":\"MCP server\",\"description\":\"Connect AI agents to Forecastable through the Integration MCP server.\",\"dateModified\":\"2026-11-18T13:33:53.950Z\",\"isPartOf\":{\"@id\":\"https://docs.forecastable.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.forecastable.com/developers/mcp#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.forecastable.com/developers/mcp#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Forecastable\",\"item\":\"https://docs.forecastable.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MCP server\",\"item\":\"https://docs.forecastable.com/developers/mcp\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.forecastable.com/developers/mcp#article\",\"headline\":\"MCP server\",\"name\":\"MCP server\",\"description\":\"Connect AI agents to Forecastable through the Integration MCP server.\",\"url\":\"https://docs.forecastable.com/developers/mcp\",\"mainEntityOfPage\":{\"@id\":\"https://docs.forecastable.com/developers/mcp#webpage\"},\"dateModified\":\"2026-11-18T13:33:53.950Z\",\"publisher\":{\"@id\":\"https://docs.forecastable.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.forecastable.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Forecastable\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Forecastable\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developers/mcp.md","siteName":"Forecastable","nav":{"global":{"anchors":[{"anchor":"Documentation","icon":"book-open-cover","href":"https://docs.forecastable.com"},{"anchor":"Blog","icon":"newspaper","href":"https://forecastable.com/blog"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":""},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Administration","pages":[{"title":"Sign-in methods and account linking","sidebarTitle":"Sign-in methods","href":"/administration/sign-in-methods"},{"title":"Set up single sign-on","sidebarTitle":"Single sign-on","href":"/administration/single-sign-on"},{"title":"Identity trust policies","href":"/administration/sso-trust-policies"},{"title":"Troubleshoot single sign-on","description":"Resolve DNS, provider, email trust, account linking, callback, and recovery problems.","href":"/administration/sso-troubleshooting"}]},{"group":"AI","pages":[{"title":"MCP server","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/mcp.png","href":"/developers/mcp"}]},{"group":"Developers","pages":[{"title":"API keys","description":"Create and manage Integration API keys for direct REST and MCP access.","href":"/developers/api-keys"},{"title":"OAuth apps","href":"/developers/oauth"},{"title":"Scopes","href":"/developers/scopes"},{"title":"Rate limits","href":"/developers/rate-limits"}]},{"group":"Integrations","pages":[{"group":"Agents","expanded":true,"pages":[{"title":"ChatGPT integration","sidebarTitle":"ChatGPT","href":"/integrations/chatgpt"},{"title":"Claude integration","sidebarTitle":"Claude","href":"/integrations/claude"},{"title":"Cursor integration","sidebarTitle":"Cursor","href":"/integrations/cursor"}]},{"group":"Messaging","expanded":true,"pages":[{"title":"Slack integration","sidebarTitle":"Slack","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/slack.svg","href":"/integrations/slack"},{"title":"Microsoft Teams integration","sidebarTitle":"Microsoft Teams","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/teams.png","href":"/integrations/teams"},{"title":"LinkedIn integration","sidebarTitle":"LinkedIn","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/linkedin.svg","href":"/integrations/linkedin"}]},{"group":"Email","expanded":true,"pages":[{"title":"Gmail integration","sidebarTitle":"Gmail","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/gmail.svg","href":"/integrations/gmail"},{"title":"Microsoft 365 email integration","sidebarTitle":"Microsoft 365","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/microsoft.png","href":"/integrations/microsoft"},{"title":"IMAP integration","sidebarTitle":"IMAP","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/imap.svg","href":"/integrations/imap"}]},{"group":"Conferencing","expanded":true,"pages":[{"title":"Fathom.ai integration","sidebarTitle":"Fathom.ai","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/fathom.png","href":"/integrations/fathom"},{"title":"Gong integration","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/gong.png","href":"/integrations/gong"},{"title":"Avoma integration","sidebarTitle":"Avoma","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/avoma.png","href":"/integrations/avoma"}]},{"group":"CRM","expanded":true,"pages":[{"title":"HubSpot integration","sidebarTitle":"HubSpot","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/hubspot.png","href":"/integrations/hubspot"},{"title":"Salesforce integration","sidebarTitle":"Salesforce","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/salesforce.png","href":"/integrations/salesforce"}]},{"group":"Data","expanded":true,"pages":[{"title":"Apollo.io integration","sidebarTitle":"Apollo.io","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/apollo.png","href":"/integrations/apollo"},{"title":"ZoomInfo integration","sidebarTitle":"ZoomInfo","icon":"https://mintlify.s3.us-west-1.amazonaws.com/forecastable/images/integrations/logos/zoominfo.png","href":"/integrations/zoominfo"}]}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/meta/get-integration-api-metadata"}]}]},"basePath":"","title":"MCP server - Forecastable","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}