pypi orita-mcpstdioMITupdated 1mo ago
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 can you do with 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
Install
Add orita provider resolution to your client. Pick the one you use.
claude mcp add orita-mcp -- uvx orita-mcpcodex mcp add orita-mcp -- uvx orita-mcpamp mcp add orita-mcp -- uvx orita-mcp{
"mcpServers": {
"orita-mcp": {
"command": "uvx",
"args": [
"orita-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"orita-mcp": {
"command": "uvx",
"args": [
"orita-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"orita-mcp","command":"uvx","args":["orita-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"orita-mcp": {
"command": "uvx",
"args": [
"orita-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"orita-mcp": {
"command": "uvx",
"args": [
"orita-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"orita-mcp": {
"command": "uvx",
"args": [
"orita-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"orita-mcp": {
"type": "local",
"command": "uvx",
"args": [
"orita-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"orita-mcp": {
"command": {
"path": "uvx",
"args": [
"orita-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
uvx orita-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
10 tools
orita provider resolution exposes 10 tools to a connected agent.
- resolve_scheduling
- Search provider network, apply eligibility rules, return ranked explained options
- get_resolution
- Retrieve resolution with options, exclusions, and expiry
- hold_scheduling_option
- Temporarily hold a slot (2 min default, 10 min max)
- release_scheduling_option
- Release a held slot
- confirm_scheduling_resolution
- Create the booking after customer approval
- reschedule_booking
- Move to a new approved slot
- cancel_booking
- Cancel a booking
- get_booking
- Retrieve booking details
- list_professionals
- List providers in the network
- get_slots
- Get slots for a known provider
Score
74 / 100
Good
- Documentation22/25
- Maintenance16/25
- Trust13/20
- Capability11/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 32 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 10 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.1.1Latest | Jul 31, 2026 |