{"openapi":"3.1.0","info":{"title":"ConsultingRate API","version":"0.1.0","description":"A fully local consulting-fee-structure and rate-setting toolkit: a real fee-structure-type comparison, a consulting-specific rate calculator (materially lower billable ratio than execution-focused freelance work), a retainer estimator, and a scope-creep-prevention contract-clause reference.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://consultingrate.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/consultingrate/docs"},"termsOfService":"https://connectorbay.com/consultingrate/terms"},"servers":[{"url":"https://consultingrate.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/consultingrate/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/fee_structure_comparison":{"post":{"operationId":"fee_structure_comparison","summary":"A real comparison of the four common consulting fee structures -- hourly, project-based/fixed-fee,","description":"A real comparison of the four common consulting fee structures -- hourly, project-based/fixed-fee,\n    retainer, value-based -- each with how it works and genuine tradeoffs. Use for \"hourly vs value-based\n    pricing for consulting\", \"what are the pros and cons of a retainer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"structure":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"hourly | project_fixed_fee | retainer | value_based. Omit to compare all four.","title":"Structure"}},"title":"fee_structure_comparisonArguments","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/consulting_rate_calculator":{"post":{"operationId":"consulting_rate_calculator","summary":"Computes a real hourly and day consulting rate from target income and overhead, dividing by required","description":"Computes a real hourly and day consulting rate from target income and overhead, dividing by required\n    billable hours (working weeks x hours/week x billable ratio). Uses a consulting-specific billable ratio\n    (default 50%) materially lower than an execution-focused freelancer's typical ~75%, so it produces a\n    genuinely higher rate than a freelancer-style formula for the same income and overhead. Use for \"what\n    should my consulting rate be if I want $150,000 and have $20,000 in overhead\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"target_annual_income":{"description":"Desired annual take-home income.","minimum":0,"title":"Target Annual Income","type":"number"},"annual_overhead_costs":{"description":"Annual business costs: insurance, software, marketing/BD spend, admin support, etc.","minimum":0,"title":"Annual Overhead Costs","type":"number"},"billable_ratio_pct":{"default":50.0,"description":"Share of working hours that are billable, 30-65 (default 50) -- consulting's materially lower ratio than execution-freelance work.","maximum":65,"minimum":30,"title":"Billable Ratio Pct","type":"number"},"working_weeks_per_year":{"default":48.0,"description":"Weeks worked per year, accounting for vacation/holidays (default 48).","exclusiveMinimum":0,"maximum":52,"title":"Working Weeks Per Year","type":"number"},"hours_per_week":{"default":40.0,"description":"Working hours per week (default 40).","exclusiveMinimum":0,"title":"Hours Per Week","type":"number"}},"required":["target_annual_income","annual_overhead_costs"],"title":"consulting_rate_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/retainer_estimate":{"post":{"operationId":"retainer_estimate","summary":"Estimates a monthly retainer fee from an hourly rate and a committed monthly hour bucket, with an","description":"Estimates a monthly retainer fee from an hourly rate and a committed monthly hour bucket, with an\n    optional volume discount. Use for \"estimate a monthly retainer for 15 hours a month at my rate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hourly_rate":{"description":"Your hourly consulting rate.","exclusiveMinimum":0,"title":"Hourly Rate","type":"number"},"hours_per_month":{"description":"Committed monthly hour bucket.","exclusiveMinimum":0,"title":"Hours Per Month","type":"number"},"volume_discount_pct":{"default":0.0,"description":"Optional volume discount for the recurring commitment, 0-40 (default 0).","maximum":40,"minimum":0,"title":"Volume Discount Pct","type":"number"}},"required":["hourly_rate","hours_per_month"],"title":"retainer_estimateArguments","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/scope_creep_prevention_reference":{"post":{"operationId":"scope_creep_prevention_reference","summary":"Real contract-clause concepts that prevent scope creep: defined deliverables, a change-order process,","description":"Real contract-clause concepts that prevent scope creep: defined deliverables, a change-order process,\n    an out-of-scope-examples clause, revision limits, milestone-based payment, and an assumptions section.\n    Use for \"how do I prevent scope creep in a consulting contract\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"scope_creep_prevention_referenceArguments","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/consultingrate_glossary":{"post":{"operationId":"consultingrate_glossary","summary":"Definitions of consulting rate-setting terms: billable ratio, change order, utilization rate, day rate,","description":"Definitions of consulting rate-setting terms: billable ratio, change order, utilization rate, day rate,\n    value-based pricing, scope creep. Use for \"what's a billable ratio\", \"what's a change order\".","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":"consultingrate_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}}}}