{"openapi":"3.1.0","info":{"title":"SideHustle API","version":"0.1.0","description":"US gig-economy / side-income tax calculators: self-employment tax, quarterly estimated-tax due dates and safe harbor, the current-year standard mileage rate(s), deductible-expense and recordkeeping checklists, a 1099-vs-W-2 explainer, and a glossary — all local, from bundled verified IRS figures.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://sidehustle.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/sidehustle/docs"},"termsOfService":"https://connectorbay.com/sidehustle/terms"},"servers":[{"url":"https://sidehustle.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/sidehustle/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/self_employment_tax":{"post":{"operationId":"self_employment_tax","summary":"Self-employment tax (15.3% of 92.35% of net profit: 12.4% Social Security up to the wage base, 2.9%","description":"Self-employment tax (15.3% of 92.35% of net profit: 12.4% Social Security up to the wage base, 2.9%\n    Medicare, plus 0.9% Additional Medicare over your filing-status threshold), coordinated with any W-2 wages,\n    plus the deductible employer-equivalent half. Use for \"self-employment tax on $60,000 net profit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"net_profit":{"description":"Schedule C (or similar) net profit for the year.","minimum":0,"title":"Net Profit","type":"number"},"filing_status":{"default":"single","description":"single | head_of_household | married_joint | married_separate","title":"Filing Status","type":"string"},"year":{"default":"2026","description":"Tax year: 2025 | 2026","title":"Year","type":"string"},"other_ss_wages_ytd":{"default":0.0,"description":"Wages already subject to Social Security tax this year from a W-2 job, if any.","minimum":0,"title":"Other Ss Wages Ytd","type":"number"},"other_medicare_wages":{"default":0.0,"description":"All Medicare wages this year from a W-2 job (uncapped), if any.","minimum":0,"title":"Other Medicare Wages","type":"number"}},"required":["net_profit"],"title":"self_employment_taxArguments","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/quarterly_estimated_tax_schedule":{"post":{"operationId":"quarterly_estimated_tax_schedule","summary":"The current year's four IRS quarterly estimated-tax due dates, plus (if you provide an estimate) the","description":"The current year's four IRS quarterly estimated-tax due dates, plus (if you provide an estimate) the\n    safe-harbor target amount and a suggested even quarterly payment. Use for \"when are my 2026 quarterly\n    estimated taxes due\", \"how much should I pay each quarter to avoid a penalty\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"default":"2026","description":"Tax year: 2025 | 2026","title":"Year","type":"string"},"estimated_annual_tax":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Your estimated total tax for this year, if known.","title":"Estimated Annual Tax"},"prior_year_total_tax":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Your total tax from last year's return, if known.","title":"Prior Year Total Tax"},"prior_year_agi":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Your Adjusted Gross Income from last year's return (needed to check the 110% high-income safe-harbor rule).","title":"Prior Year Agi"},"filing_status":{"default":"single","description":"single | head_of_household | married_joint | married_separate","title":"Filing Status","type":"string"}},"title":"quarterly_estimated_tax_scheduleArguments","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/mileage_deduction":{"post":{"operationId":"mileage_deduction","summary":"Mileage deduction using the correct current-year standard mileage rate(s) — 2026 has two (72.5 cents","description":"Mileage deduction using the correct current-year standard mileage rate(s) — 2026 has two (72.5 cents\n    Jan-Jun, 76 cents Jul-Dec after a mid-year IRS increase); 2025 is a flat 70 cents all year. Use for \"mileage\n    deduction for 8,000 business miles in 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"business_miles_period1":{"description":"Business miles driven in the year's first mileage-rate period (all of the year for years with one flat rate).","minimum":0,"title":"Business Miles Period1","type":"number"},"business_miles_period2":{"default":0.0,"description":"Business miles driven in the year's second mileage-rate period, if the year had a mid-year rate change (e.g. 2026: Jul 1 – Dec 31).","minimum":0,"title":"Business Miles Period2","type":"number"},"year":{"default":"2026","description":"Tax year: 2025 | 2026","title":"Year","type":"string"}},"required":["business_miles_period1"],"title":"mileage_deductionArguments","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/deductible_expense_checklist":{"post":{"operationId":"deductible_expense_checklist","summary":"A hand-curated checklist of common gig/side-income deductible expense categories (mileage, home office,","description":"A hand-curated checklist of common gig/side-income deductible expense categories (mileage, home office,\n    supplies, phone/internet, health insurance, retirement contributions, ...). Use for \"what can I deduct for\n    my side gig\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"deductible_expense_checklistArguments","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/classification_1099_vs_w2":{"post":{"operationId":"classification_1099_vs_w2","summary":"Explains the IRS's worker-classification factors and the practical differences between a 1099","description":"Explains the IRS's worker-classification factors and the practical differences between a 1099\n    independent contractor and a W-2 employee. Use for \"am I a 1099 contractor or should I be a W-2 employee\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"classification_1099_vs_w2Arguments","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/recordkeeping_checklist":{"post":{"operationId":"recordkeeping_checklist","summary":"A checklist of what records a gig/side-income worker should keep and for how long. Use for \"what records","description":"A checklist of what records a gig/side-income worker should keep and for how long. Use for \"what records\n    do I need to keep for my side gig\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"recordkeeping_checklistArguments","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/sidehustle_glossary":{"post":{"operationId":"sidehustle_glossary","summary":"Definitions of common gig-tax terms (self-employment tax, Schedule C/SE, 1099-NEC, 1099-K, safe harbor,","description":"Definitions of common gig-tax terms (self-employment tax, Schedule C/SE, 1099-NEC, 1099-K, safe harbor,\n    standard mileage rate, ...). Use for \"what's Schedule SE\", \"what's the safe harbor rule\".","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":"sidehustle_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}}}}