{"openapi":"3.1.0","info":{"title":"Give USD API","version":"0.1.0","description":"US charitable-giving tax-deduction basics: standard deduction lookup, an itemize-vs-standard calculator, qualified-charity verification concept, non-cash donation valuation, appraisal-requirement thresholds, AGI percentage limits, a donor-advised fund explainer, and a glossary — all local, from bundled dated IRS figures.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://giveusd.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/giveusd/docs"},"termsOfService":"https://connectorbay.com/giveusd/terms"},"servers":[{"url":"https://giveusd.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/giveusd/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/standard_deduction_lookup":{"post":{"operationId":"standard_deduction_lookup","summary":"The current IRS standard deduction for a filing status and year, including the additional amount for","description":"The current IRS standard deduction for a filing status and year, including the additional amount for\n    being 65-or-older and/or blind. Use for \"standard deduction for 2026 married filing jointly\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filing_status":{"description":"single | married_filing_jointly | head_of_household | married_filing_separately","title":"Filing Status","type":"string"},"year":{"default":"2026","description":"Tax year: 2025 | 2026","title":"Year","type":"string"},"age_65_or_older":{"default":false,"description":"This filer is 65 or older.","title":"Age 65 Or Older","type":"boolean"},"blind":{"default":false,"description":"This filer is blind, per IRS rules.","title":"Blind","type":"boolean"}},"required":["filing_status"],"title":"standard_deduction_lookupArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/itemize_vs_standard_calculator":{"post":{"operationId":"itemize_vs_standard_calculator","summary":"Whether itemizing beats the standard deduction, and exactly how much of THIS charitable gift actually","description":"Whether itemizing beats the standard deduction, and exactly how much of THIS charitable gift actually\n    reduces taxes — a donation only helps once total itemized deductions clear the standard deduction, and\n    only the portion beyond that gap counts if other deductions alone don't already clear it. Use for \"does\n    donating $5,000 actually lower my taxes if my other deductions are $20,000\", \"should I itemize this year\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filing_status":{"description":"single | married_filing_jointly | head_of_household | married_filing_separately","title":"Filing Status","type":"string"},"charitable_gift":{"description":"The charitable gift amount being evaluated.","minimum":0,"title":"Charitable Gift","type":"number"},"other_itemized_deductions":{"default":0.0,"description":"All other itemizable deductions (mortgage interest, SALT up to the cap, other gifts, etc.), excluding this gift.","minimum":0,"title":"Other Itemized Deductions","type":"number"},"year":{"default":"2026","description":"Tax year: 2025 | 2026","title":"Year","type":"string"},"age_65_or_older":{"default":false,"description":"This filer is 65 or older.","title":"Age 65 Or Older","type":"boolean"},"blind":{"default":false,"description":"This filer is blind, per IRS rules.","title":"Blind","type":"boolean"},"marginal_tax_rate_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Optional marginal tax rate, % — if given, estimates the actual dollar tax savings from this gift.","title":"Marginal Tax Rate Pct"}},"required":["filing_status","charitable_gift"],"title":"itemize_vs_standard_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/charity_verification_concept":{"post":{"operationId":"charity_verification_concept","summary":"Why 501(c)(3)/qualified-charity status matters for deductibility, and how to check an organization's","description":"Why 501(c)(3)/qualified-charity status matters for deductibility, and how to check an organization's\n    status before giving. Use for \"is this a real charity I can deduct\", \"how do I check 501c3 status\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"charity_verification_conceptArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/noncash_donation_valuation_basics":{"post":{"operationId":"noncash_donation_valuation_basics","summary":"Fair-market-value valuation basics for non-cash donations by category: clothing/household items,","description":"Fair-market-value valuation basics for non-cash donations by category: clothing/household items,\n    vehicles/boats/airplanes (the special gross-proceeds rule), publicly traded stock, and real estate/other\n    property. Use for \"how do I value a car donation\", \"how much can I deduct for donated clothes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"clothing_and_household_items | vehicles_boats_airplanes | publicly_traded_stock | real_estate_and_other_property; omit for all.","title":"Category"}},"title":"noncash_donation_valuation_basicsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/appraisal_requirement_check":{"post":{"operationId":"appraisal_requirement_check","summary":"Applies the real IRS dollar thresholds to a donation type and value: when a written acknowledgment,","description":"Applies the real IRS dollar thresholds to a donation type and value: when a written acknowledgment,\n    Form 8283, a qualified appraisal, or attaching the appraisal to the return is required. Use for \"do I need\n    an appraisal for a $6,000 donation\", \"does my $2,000 car donation need Form 1098-C\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"donation_type":{"description":"cash | noncash | vehicle | publicly_traded_stock","title":"Donation Type","type":"string"},"fair_market_value":{"minimum":0,"title":"Fair Market Value","type":"number"}},"required":["donation_type","fair_market_value"],"title":"appraisal_requirement_checkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/charitable_deduction_agi_limit_check":{"post":{"operationId":"charitable_deduction_agi_limit_check","summary":"Applies the 60%-of-AGI (cash) and 30%-of-AGI (appreciated long-term property) deduction limits for","description":"Applies the 60%-of-AGI (cash) and 30%-of-AGI (appreciated long-term property) deduction limits for\n    gifts to public charities, with the deductible amount this year and any 5-year carryover. Use for \"can I\n    deduct all of a $200,000 gift on $250,000 AGI\", \"how much of my stock donation carries over\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"agi":{"description":"Adjusted Gross Income.","exclusiveMinimum":0,"title":"Agi","type":"number"},"cash_gift_to_public_charity":{"default":0.0,"minimum":0,"title":"Cash Gift To Public Charity","type":"number"},"appreciated_property_gift_to_public_charity":{"default":0.0,"minimum":0,"title":"Appreciated Property Gift To Public Charity","type":"number"}},"required":["agi"],"title":"charitable_deduction_agi_limit_checkArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/donor_advised_fund_explainer":{"post":{"operationId":"donor_advised_fund_explainer","summary":"What a donor-advised fund (DAF) is, why people use one (bunching, appreciated-securities gifts,","description":"What a donor-advised fund (DAF) is, why people use one (bunching, appreciated-securities gifts,\n    anonymity), the tradeoffs, and when the tax deduction is actually taken. Use for \"what's a donor-advised\n    fund\", \"when do I get the deduction for a DAF contribution\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"donor_advised_fund_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/charitable_glossary":{"post":{"operationId":"charitable_glossary","summary":"Definitions of charitable-giving tax terms: fair market value, 501(c)(3), donor-advised fund, bunching,","description":"Definitions of charitable-giving tax terms: fair market value, 501(c)(3), donor-advised fund, bunching,\n    Form 8283, qualified appraisal, carryover, cost basis, qualified charitable distribution, and more. Use\n    for \"what's bunching\", \"what's a qualified charitable distribution\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"charitable_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}