# Beeline MCP MCP > Beeline manages your external workforce operations. Connect this MCP to instantly access active assignments, search job openings, retrieve timesheets, audit suppliers, and view user profiles—all through natural conversation with any AI agent. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** contingent-workforce, vendor-management, timesheet-management, job-requisitions, talent-sourcing ## Description Managing a contingent workforce usually means jumping between a dozen dashboards. This MCP changes that by letting you talk directly to your Beeline Vendor Management System (VMS). You don't need to log in or click through menus; you just tell your agent what job status, assignment detail, or expense report you need. It pulls the data and presents it immediately. Want to audit who is working on a project? Just ask for active work assignments. Need to know if a contractor submitted their hours? You can pull up timesheets and expenses instantly. This keeps complex workforce operations right where your natural conversation happens, giving you a single point of truth that connects seamlessly into the Vinkius catalog. ## Tools ### get_assignment Retrieves specific details for a single work assignment using its ID. ### get_requisition Gets all the necessary information about one job requisition. ### get_timesheet Fetches comprehensive data for a specific timesheet report. ### get_user_info Retrieves the full profile details for any Beeline user account. ### list_assignments Provides a list of all currently active work assignments on record. ### list_expenses Lists submitted expense reports, allowing for quick auditing of spending. ### list_requisitions Returns a list of all job requisitions within the system. ### list_suppliers Pulls a comprehensive list of vendors and suppliers connected to your Beeline account. ### list_timesheets Lists submitted timesheets, helping you track who logged hours when. ### search_requisitions Searches job requisitions by a specific keyword or search term. ## Prompt Examples **Prompt:** ``` List all active assignments in Beeline. ``` **Response:** ``` I've retrieved 5 active assignments. Key entries include 'Senior Developer - Q2' (ID: asgn_123) and 'Project Manager - Retail' (ID: asgn_456). Which one would you like more details on? ``` **Prompt:** ``` Search for open requisitions matching 'React'. ``` **Response:** ``` I found 2 open requisitions matching 'React': 'Frontend Engineer (Mid-level)' (ID: req_992) and 'Fullstack JS Developer' (ID: req_995). Would you like to see the full requirements for either? ``` **Prompt:** ``` Show me recent timesheets that need review. ``` **Response:** ``` Retrieving recent timesheets... I found 8 entries from last week. All have been submitted by contractors and are awaiting manager review in the Beeline dashboard. ``` ## Capabilities ### Check active assignments Retrieve a list of all current work assignments to monitor external talent deployment. ### Search job openings Query your organization's open job requisitions using keywords or filtering criteria. ### Pull timesheets and expenses Fetch submitted time logs and expense reports for immediate auditing and approval workflows. ### Audit vendor lists List and verify the vendors and suppliers linked within your Beeline account. ### View user profiles Get detailed profile information for specific users to ensure correct system access. ## Use Cases ### The Quarterly Audit A Procurement Specialist needs to verify every third-party vendor linked to the company. Instead of exporting a spreadsheet and cross-referencing multiple internal documents, they simply ask their agent to run `list_suppliers`. The MCP returns an audited list immediately, letting them confirm all required contacts are present. ### Hiring Status Check A Hiring Manager needs to know if a specific role ('Senior Data Analyst') is still open or if it was recently filled. They ask the agent to `search_requisitions` for 'Data Analyst'. The response confirms the status and provides an ID, letting them move straight into planning. ### Weekly Timesheet Review An HR Ops analyst needs to review all timesheets submitted last week. They ask the agent to `list_timesheets`. The MCP returns a summary of entries needing approval, allowing them to flag discrepancies before sending out manual reminders. ### Troubleshooting Assignment Details A team lead needs to know why an external contractor's pay rate is incorrect. They use the agent to `get_assignment` details for that specific worker, pulling up the correct assignment metadata instantly for review. ## Benefits - Audit supplier lists and assignment metadata straight from your workflow. You can use `list_suppliers` to verify vendors or call `list_assignments` to check active deployment status, without leaving your chat interface. - Stop manually checking dashboards for job openings. Use the MCP's ability to search requisitions with `search_requisitions`, letting you find specific roles by keyword instantly. - Streamline compliance checks. You can get detailed reports on hours worked and money spent by using `list_timesheets` or calling `list_expenses` right when you need it. - Get immediate insight into any worker's status. If you only know a user ID, use `get_user_info` to pull up their profile details for verification. - Quickly see what jobs are open and what people are doing. You can run both `list_requisitions` (for openings) and `list_assignments` (for current work) in one conversation. ## How It Works The bottom line is that you use this MCP as an API layer to let your AI client talk directly to Beeline's core functions without needing credentials or UI interactions. 1. Subscribe to this MCP and enter your Beeline OAuth Access Token. 2. Direct your AI agent to the connection point via Vinkius. 3. Ask a natural language question, like 'Show me all open requisitions matching finance,' and get the data back. ## Frequently Asked Questions **Can I use get_assignment for anything other than just getting details?** No, `get_assignment` retrieves only the full record for a single assignment ID. If you need to see multiple assignments, start by using `list_assignments` first. **How do I find out if a job requisition exists?** You should use `search_requisitions`. This tool lets you search for open jobs by keyword (like 'React') and gives you the IDs of matching requisitions to review. **Do I need the list_timesheets tool if I want timesheet data?** No, `list_timesheets` just pulls a summary list of submitted sheets. If you know the specific ID, use `get_timesheet` to pull all the granular details for that single report. **What if I only have an employee's name and need their profile?** Use `get_user_info`. This tool fetches the complete Beeline user profile, ensuring you get accurate account access data regardless of whether you have a specific ID handy. **When I use `list_suppliers`, what kind of authentication token do I need?** You must provide a valid Beeline OAuth Access Token. This credential grants your agent permission to read vendor data across the system. If the token expires, the call fails with an authorization error. **If `get_assignment` returns zero results, is it possible I misspelled the assignment ID?** Yes, that’s the most common issue. The tool will return a specific 'Not Found' status if the provided ID doesn't map to an active record in Beeline. Double-check the source system for accuracy. **Can I filter my results when running `list_assignments` by completion date or status?** You can pass specific parameters during the call to narrow down the search. For example, you'll need to specify a start and end date range to pull assignments completed in Q2. **How do I use `list_timesheets` data alongside details from `list_expenses`?** You must link them using the contractor ID or internal employee identifier. First, run `list_timesheets` to get a list of IDs, then pass those specific IDs when calling the expense listing tool. **Can I check the status of a specific job requisition from the agent?** Yes! Use the `get_requisition` tool with the Requisition ID. Your agent will fetch the latest status and metadata directly from the Beeline cloud. **How do I list all active assignments for my department?** Simply ask the agent to `list_assignments`. It will retrieve the current work orders and assignments linked to your account for your review. **Does the integration support approving timesheets directly?** Currently, the toolset is focused on querying and auditing (Read-Only). You can list and inspect timesheets, but approvals must be performed within the Beeline VMS platform for security compliance.