io.github.Alkilo-do/orita-provider-resolution

orita-mcp

MCP server for the Orita Provider Resolution API — lets AI agents search a provider network, apply eligibility rules, resolve availability, and safely confirm bookings.

What this does

Orita resolves the provider-routing problem:

Your application knows what service the customer needs, but not which professional is eligible and available.

This MCP server exposes that resolution workflow as tools that AI agents (Claude, Cursor, and compatible clients) can call natively.

Primary workflow

resolve_scheduling          → search provider network, return ranked options
hold_scheduling_option      → temporarily reserve the selected slot
confirm_scheduling_resolution → confirm booking after customer approval

Tools

Tool	Description	Modifies state?
resolve_scheduling	Search provider network, apply eligibility rules, return ranked explained options	No
get_resolution	Retrieve resolution with options, exclusions, and expiry	No
hold_scheduling_option	Temporarily hold a slot (2 min default, 10 min max)	Application-defined
release_scheduling_option	Release a held slot	Yes
confirm_scheduling_resolution	Create the booking after customer approval	Yes — requires approval
reschedule_booking	Move to a new approved slot	Yes — requires approval
cancel_booking	Cancel a booking	Yes — requires approval
get_booking	Retrieve booking details	No
list_professionals	List providers in the network	No
get_slots	Get slots for a known provider	No

Agent safety

✓ resolve_scheduling, get_resolution, list_professionals, get_slots
  → No customer approval required

⚠ hold_scheduling_option
  → Application-defined

✗ confirm_scheduling_resolution, reschedule_booking, cancel_booking
  → Require explicit customer approval before calling
  → Display provider, service, time, timezone, and cancellation policy first

Never call confirm_scheduling_resolution until the customer has explicitly approved:

• Provider name
• Service
• Date and time
• Timezone
• Cancellation policy

Connect via remote server

{
  "mcpServers": {
    "orita": {
      "url": "https://orita.online/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ORITA_API_KEY"
      }
    }
  }
}

Note: Requests must include Accept: application/json, text/event-stream. MCP-compatible clients send this automatically.

Install via PyPI

pip install orita-mcp
ORITA_API_KEY=orita_... python -m orita_mcp

Get an API key

Free at orita.online/sign-up — no credit card. 50 active providers, 5,000 resolutions/month included on the free plan.

Resources

• Developer docs
• MCP documentation
• API reference
• OpenAPI spec
• Node.js SDK
• Python SDK