TurboTax MCP server for AI agents
Let Claude, ChatGPT or your own agent read TurboTax: 11 typed functions through one MCP server. No TurboTax API key needed.
- Functions
- 11
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for TurboTax alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/turbotaxOne MCP server for TurboTax and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
compareEditionsCompare TurboTax editions side by side, showing which features each includes.Arguments
None.
Returns
TurboTaxComparison[]interface TurboTaxComparison { tier: "diy" | "live-assisted" | "full-service"; title: string; recommended: boolean; /** The site's own selling-point sentences for this tier, read off the page, never guessed from prose. */ features: string[]; // the site's own labels, read the values off a result, never guess one from prose federalPriceRange: { min: number; max: number } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/compareEditionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.compareEditions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.compareEditions())curl -X POST https://api.bowmark.ai/v1/sites/turbotax/compareEditions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.compareEditions();estimateRefundEstimate a federal refund or amount owed with TurboTax's TaxCaster from filing status, income, withholding and dependents.Arguments
Name Type Required filingStatus"single" | "married-joint" | "married-separate" | "head-of-household" | "qualifying-surviving-spouse"Yes taxYearnumber2025 (default) or 2026, the only years TaxCaster computes.No wagesnumberAll money below is whole US dollars for the year.No federalWithholdingnumberNo agenumberNo spouseWagesnumberSpouse fields count only for "married-joint".No spouseFederalWithholdingnumberNo spouseAgenumberNo spouseSelfEmploymentIncomenumberNo selfEmploymentIncomenumberNo dependentsUnder17numberNo dependentsUnder13numberOf dependentsUnder17, how many are under 13 (childcare credit).No studentsAged17To23numberNo otherDependentsnumberNo claimedAsDependentbooleanNo unemploymentIncomenumberNo socialSecurityIncomenumberNo taxableInterestnumberNo ordinaryDividendsnumberNo qualifiedDividendsnumberNo longTermCapitalGainsnumberNo shortTermCapitalGainsnumberNo iraDistributionnumberNo iraContributionnumberNo otherIncomenumberNo tipIncomenumberNo overtimePaynumberNo studentLoanInterestnumberNo mortgageInterestnumberNo realEstateTaxnumberNo cashDonationsnumberNo medicalExpensesnumberNo estimatedTaxPaidnumberNo Returns
TurboTaxRefundEstimateinterface TurboTaxRefundEstimate { taxYear: number; /** Whole US dollars. Positive = refund, negative = amount owed. */ refund: number; owes: boolean; totalTax: number; totalCredits: number; totalPayments: number; taxableIncome: number; standardDeduction: number; /** Percent, e.g. 13.42. */ effectiveTaxRate: number; /** Marginal federal bracket in percent, e.g. 22. */ taxBracket: number; /** TaxCaster's own engine stamp, e.g. "taxEngine2025:12". */ engine: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/estimateRefundCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.estimateRefund({ filingStatus: "single", wages: 75000, federalWithholding: 9000 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.estimateRefund({ "filingStatus": "single", "wages": 75000, "federalWithholding": 9000 }))curl -X POST https://api.bowmark.ai/v1/sites/turbotax/estimateRefund \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"filingStatus":"single","wages":75000,"federalWithholding":9000}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.estimateRefund({ filingStatus: "single", wages: 75000, federalWithholding: 9000 });estimateSelfEmploymentTaxEstimate self-employment tax and quarterly payments on 1099 income with TurboTax's self-employed calculator.Arguments
Name Type Required filingStatus"single" | "married-joint" | "married-separate" | "head-of-household" | "qualifying-surviving-spouse"Yes taxYearnumber2025 (default) or 2026, the only years TaxCaster computes.No wagesnumberAll money below is whole US dollars for the year.No federalWithholdingnumberNo agenumberNo spouseWagesnumberSpouse fields count only for "married-joint".No spouseFederalWithholdingnumberNo spouseAgenumberNo spouseSelfEmploymentIncomenumberNo selfEmploymentIncomenumberNo dependentsUnder17numberNo dependentsUnder13numberOf dependentsUnder17, how many are under 13 (childcare credit).No studentsAged17To23numberNo otherDependentsnumberNo claimedAsDependentbooleanNo unemploymentIncomenumberNo socialSecurityIncomenumberNo taxableInterestnumberNo ordinaryDividendsnumberNo qualifiedDividendsnumberNo longTermCapitalGainsnumberNo shortTermCapitalGainsnumberNo iraDistributionnumberNo iraContributionnumberNo otherIncomenumberNo tipIncomenumberNo overtimePaynumberNo studentLoanInterestnumberNo mortgageInterestnumberNo realEstateTaxnumberNo cashDonationsnumberNo medicalExpensesnumberNo estimatedTaxPaidnumberNo Returns
TurboTaxSelfEmploymentEstimateinterface TurboTaxRefundEstimate { taxYear: number; /** Whole US dollars. Positive = refund, negative = amount owed. */ refund: number; owes: boolean; totalTax: number; totalCredits: number; totalPayments: number; taxableIncome: number; standardDeduction: number; /** Percent, e.g. 13.42. */ effectiveTaxRate: number; /** Marginal federal bracket in percent, e.g. 22. */ taxBracket: number; /** TaxCaster's own engine stamp, e.g. "taxEngine2025:12". */ engine: string | null; } interface TurboTaxSelfEmploymentEstimate extends TurboTaxRefundEstimate { /** Schedule SE tax (Social Security + Medicare) on the 1099 income, whole US dollars. */ selfEmploymentTax: number; /** totalTax less selfEmploymentTax. */ incomeTax: number; /** A quarter of what is still owed after withholding, each Form 1040-ES payment. */ quarterlyEstimatedPayment: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/estimateSelfEmploymentTaxCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.estimateSelfEmploymentTax({ filingStatus: "single", selfEmploymentIncome: 60000 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.estimateSelfEmploymentTax({"filingStatus": "single", "selfEmploymentIncome": 60000}))curl -X POST https://api.bowmark.ai/v1/sites/turbotax/estimateSelfEmploymentTax \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"filingStatus":"single","selfEmploymentIncome":60000}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.estimateSelfEmploymentTax({ filingStatus: "single", selfEmploymentIncome: 60000 });estimateWithholdingEstimate per-paycheck federal withholding with TurboTax's W-4 calculator.Arguments
Name Type Required argsEstimateWithholdingArgsYes interface EstimateRefundArgs { filingStatus: "single" | "married-joint" | "married-separate" | "head-of-household" | "qualifying-surviving-spouse"; /** 2025 (default) or 2026, the only years TaxCaster computes. */ taxYear?: number; /** All money below is whole US dollars for the year. */ wages?: number; federalWithholding?: number; age?: number; /** Spouse fields count only for "married-joint". */ spouseWages?: number; spouseFederalWithholding?: number; spouseAge?: number; spouseSelfEmploymentIncome?: number; selfEmploymentIncome?: number; dependentsUnder17?: number; /** Of dependentsUnder17, how many are under 13 (childcare credit). */ dependentsUnder13?: number; studentsAged17To23?: number; otherDependents?: number; claimedAsDependent?: boolean; unemploymentIncome?: number; socialSecurityIncome?: number; taxableInterest?: number; ordinaryDividends?: number; qualifiedDividends?: number; longTermCapitalGains?: number; shortTermCapitalGains?: number; iraDistribution?: number; iraContribution?: number; otherIncome?: number; tipIncome?: number; overtimePay?: number; studentLoanInterest?: number; mortgageInterest?: number; realEstateTax?: number; cashDonations?: number; medicalExpenses?: number; estimatedTaxPaid?: number; } interface EstimateWithholdingArgs extends Omit<EstimateRefundArgs, "federalWithholding"> { payFrequency: "weekly" | "biweekly" | "semimonthly" | "monthly"; /** Federal tax withheld from each paycheck now, whole US dollars. */ withheldPerPaycheck: number; /** Federal tax withheld so far this year. */ withheldSoFar?: number; /** YYYY-MM-DD this year; defaults to today. */ nextPaycheckDate?: string; }Returns
TurboTaxWithholdingEstimateinterface TurboTaxRefundEstimate { taxYear: number; /** Whole US dollars. Positive = refund, negative = amount owed. */ refund: number; owes: boolean; totalTax: number; totalCredits: number; totalPayments: number; taxableIncome: number; standardDeduction: number; /** Percent, e.g. 13.42. */ effectiveTaxRate: number; /** Marginal federal bracket in percent, e.g. 22. */ taxBracket: number; /** TaxCaster's own engine stamp, e.g. "taxEngine2025:12". */ engine: string | null; } interface TurboTaxWithholdingEstimate extends TurboTaxRefundEstimate { paychecksLeft: number; /** Withheld so far plus the per-paycheck amount over every paycheck left. */ projectedWithholding: number; /** Extra dollars per paycheck for W-4 line 4(c) so the year ends owing nothing; 0 when already on track for a refund. */ extraPerPaycheckToBreakEven: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/estimateWithholdingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.estimateWithholding({ filingStatus: "single", wages: 80000, payFrequency: "biweekly", withheldPerPaycheck: 300, withheldSoFar: 6000 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.estimateWithholding({ "filingStatus": "single", "wages": 80000, "payFrequency": "biweekly", "withheldPerPaycheck": 300, "withheldSoFar": 6000 }))curl -X POST https://api.bowmark.ai/v1/sites/turbotax/estimateWithholding \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"filingStatus":"single","wages":80000,"payFrequency":"biweekly","withheldPerPaycheck":300,"withheldSoFar":6000}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.estimateWithholding({ filingStatus: "single", wages: 80000, payFrequency: "biweekly", withheldPerPaycheck: 300, withheldSoFar: 6000 });findLocalExpertsFind TurboTax Full Service offices near a US ZIP code.Arguments
Name Type Required zipstringYes Returns
TurboTaxOffice[]interface TurboTaxOffice { name: string; phone: string | null; address: string; city: string; state: string; zip: string; latitude: number; longitude: number; hours: Array<{ day: string; open: string; close: string }>; url: string; /** Great-circle distance from the searched ZIP, in miles. */ distanceMiles: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/findLocalExpertsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.findLocalExperts("10001");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.findLocalExperts("10001"))curl -X POST https://api.bowmark.ai/v1/sites/turbotax/findLocalExperts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"zip":"10001"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.findLocalExperts("10001");getArticleRead one TurboTax help article (a ttlc.intuit.com url searchArticles returned): its title, full body text and related links.Arguments
Name Type Required urlstringYes Returns
TurboTaxHelpArticleinterface TurboTaxHelpArticle { title: string; url: string; /** The page's own "Updated" stamp as written, e.g. "September 29, 2026 2:51 PM"; null when absent. */ updated: string | null; /** The full article as plain text, one paragraph or list step per line (steps start "- "). */ body: string; /** The page's "More like this" articles, each url is another getArticle argument. */ related: Array<{ title: string; url: string }>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.getArticle("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.getArticle("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/turbotax/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.getArticle("<url>");getLocalExpertRead one TurboTax local tax expert's profile page: job title, bio, specialties, rating, review count and office address.Arguments
Name Type Required urlstringYes Returns
TurboTaxExpertinterface TurboTaxExpert { name: string; /** e.g. "TurboTax Tax Expert" or "TurboTax Full Service Tax Expert"; null when absent. */ jobTitle: string | null; description: string | null; /** The site's own tax-topic tags for this expert, e.g. "Retirement Income". */ specialties: string[]; /** 1-5; null when the profile carries no rating yet. */ rating: number | null; reviewCount: number | null; image: string | null; address: { street: string; city: string; state: string; zip: string } | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/getLocalExpertCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.getLocalExpert("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.getLocalExpert("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/turbotax/getLocalExpert \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.getLocalExpert("<url>");getLocalOfficeRead one TurboTax local tax office page: address, the tax topics it offers, and the tax experts working there, each with the /local-tax-experts/…Arguments
Name Type Required urlstringYes Returns
TurboTaxOfficeDetailinterface TurboTaxOfficeDetail { url: string; address: string; city: string; state: string; zip: string; /** Tax topics this office's own offer catalog lists, e.g. "Cryptocurrency", "K-1 Partnership". */ services: string[]; /** This office's own tax experts, pass one's `url` to getLocalExpert. */ experts: Array<{ name: string; url: string }>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/getLocalOfficeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.getLocalOffice("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.getLocalOffice("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/turbotax/getLocalOffice \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.getLocalOffice("<url>");listEditionsList all TurboTax editions with their names, prices, and product pages.Arguments
None.
Returns
TurboTaxEdition[]interface TurboTaxEdition { /** The page's own key, e.g. "DIY_DELUXE", "DIWM_PREMIUM", "DIFM_FBP". */ id: string; /** diy = file yourself, live-assisted = expert help on demand, full-service = an expert files for you. */ tier: "diy" | "live-assisted" | "full-service"; /** basic, deluxe, premium, business, sole-proprietor, full-service. */ plan: string; /** Current federal price in whole US dollars; null when the page withholds it. */ federalPrice: number | null; /** The pre-discount federal price. */ federalListPrice: number | null; /** Price per state return in whole US dollars. */ statePrice: number | null; sku: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/listEditionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.listEditions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.listEditions())curl -X POST https://api.bowmark.ai/v1/sites/turbotax/listEditions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.listEditions();listTaxToolsList available tax calculation tools: TaxCaster, tax bracket, W-4, self-employed, and investment calculators.Arguments
None.
Returns
TurboTaxTool[]interface TurboTaxTool { name: string; description: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/listTaxToolsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.listTaxTools();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.listTaxTools())curl -X POST https://api.bowmark.ai/v1/sites/turbotax/listTaxTools \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.listTaxTools();searchArticlesSearch the TurboTax help library on ttlc.intuit.com for tax articles and guides.Arguments
Name Type Required querystringYes Returns
TurboTaxArticle[]interface TurboTaxArticle { title: string; url: string; /** A short excerpt from the article, as the help-search index returns it. */ snippet: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/turbotax/searchArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.turbotax.searchArticles("W-2");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.turbotax.searchArticles("W-2"))curl -X POST https://api.bowmark.ai/v1/sites/turbotax/searchArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"W-2"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.turbotax.searchArticles("W-2");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/turbotax/<function> - OpenAPI
/v1/sites/turbotax/openapi.json