Bring Appointment Booking
to OpenAI Agents SDK
Create your Vinkius account to connect Picktime to OpenAI Agents SDK and start using all 10 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
Compatible with every major AI agent and IDE
What is the Picktime MCP Server?
Connect your Picktime organization account to your AI agent and turn complex scheduling and availability management into a simple chat conversation.
What you can do
- Space & Resources — Easily retrieve structural logistics utilizing
list_locationsand inspect the service portfolio actively usinglist_services. - Staff Management — Gather team rosters through
list_staffto orchestrate proper assignment mappings for upcoming reservations. - Booking Operations — Execute deep audits with
list_bookings, review detailed entries (get_booking_details), and cleanly back out utilizingcancel_booking. - Availability Mapping — Audit live calendar empty spots using
get_availabilityor check structured slots vialist_classesfor seamless planning.
How it works
- Subscribe to this server
- Enter your Enterprise Picktime API Key
- Start fetching availability windows or querying the status of corporate locations natively through Claude, Cursor, or any configured AI
Who is this for?
- Client Relations & Receptionists — check if the stylist or doctor is free this afternoon without clicking through the calendar interface.
- Business Directors — extract all reservations of the day into a bulleted list to organize daily briefings and forecast team loads.
- Tech Teams — test availability integrations structurally from your terminal building enterprise webhook handlers.
Built-in capabilities (10)
Cancel a Picktime booking with a reason. The customer receives a cancellation notification and the time slot becomes available again for new bookings
Get available booking time slots for a specific Picktime service on a given date. Returns free windows considering staff schedules, existing bookings, and buffer times. Essential for building custom booking flows
Get full details of a specific Picktime booking including customer contact info, service booked, staff assigned, start/end times, payment status, and any customer notes
Used to resolve workspace boundaries before hitting schedules. Get detailed configuration for a specific Picktime location by ID. Returns location name, address, timezone, working hours, booking URL, and linked calendar/payment integrations
Get detailed configuration for a specific Picktime service. Returns name, duration, price, description, staff assignments, booking limits, and cancellation policy
List all bookings for a Picktime location with optional date filter. Returns customer names, booked services, staff assignments, times, statuses, and payment info. Essential for schedule management
List all group classes configured for a Picktime location. Classes are multi-attendee bookings with capacity limits — yoga sessions, workshops, group trainings
List all business locations configured in Picktime. Each location operates independently with its own services, staff, working hours, and booking pages. Multi-location businesses manage branches separately
List all bookable services for a Picktime location. Returns service names, durations, prices, descriptions, assigned staff, and buffer times. Services define what customers can book
List all staff members at a Picktime location. Returns staff names, emails, roles, assigned services, working hours, and active status. Staff availability determines bookable time slots
Why OpenAI Agents SDK?
The OpenAI Agents SDK auto-discovers all 10 tools from Picktime through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Picktime, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
- —
Native MCP integration via
MCPServerSse, pass the URL and the SDK auto-discovers all tools with full type safety - —
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
- —
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
- —
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Picktime in OpenAI Agents SDK
Why run Picktime with Vinkius?
The Picktime connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 10 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.

* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.




Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Picktime using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Picktime and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Picktime to OpenAI Agents SDK through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
Picktime for OpenAI Agents SDK
Every request between OpenAI Agents SDK and Picktime is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
Can the AI find an available slot for a specific service next Friday?
Yes. Upon providing the location and service ID along with the desired date, your agent invokes get_availability. The connector reads Picktime's master block array, isolating the open time windows seamlessly against existing rules (like business hours and buffers).
If a customer cancels on the phone, can the AI remove their booking?
Absolutely. Just provide the booking ID to the agent and it will utilize the cancel_booking function. Picktime will release the blocked slot immediately back to the customer-facing booking page.
Can I grab all upcoming appointments for a specific staff member?
Yes, by matching the staff member's ID from list_staff with the broader fetch generated by list_bookings. Alternatively, your agent can sort and filter the returned array natively in its reasoning stream, showing you only Dr. Silva's schedule.
How does the OpenAI Agents SDK connect to MCP?
Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.
Can I use multiple MCP servers in one agent?
Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.
Does the SDK support streaming responses?
Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.
MCPServerStreamableHttp not found
Ensure you have the latest version: pip install --upgrade openai-agents
Agent not calling tools
Make sure your prompt explicitly references the task the tools can help with.
Explore More MCP Servers
View all →
CoinGecko
8 toolsEnable your AI agent to query crypto prices, market rankings, and global market stats via the CoinGecko API.

ChatBot.com
8 toolsManage conversational AI and bot workflows via ChatBot — track stories, interactions, and user data directly from any AI agent.

ImageKit (Media Optimization & DAM)
10 toolsManage and optimize media via ImageKit — list files, purge CDN cache, and audit image metadata.

Replicate
12 toolsEquip your AI to dynamically search, run, and monitor thousands of open-source machine learning models hosted on Replicate via simple text commands.
