What works in ChatGPT
The Requidex MCP server works in ChatGPT developer mode as a remote MCP app. Developer mode can use the arbitrary MCP tools exposed by the server, including the generated read-only open_api_* tools and the search/fetch tools for Requidex help guides.
For product knowledge questions, ChatGPT can search Requidex Intercom help guides and fetch the full guide text. For live operational data, use developer mode or another MCP client that can call the structured Open API tools.
Before you start
Use the MCP server URL: https://api.requidex.com/mcp
Use a ChatGPT account that has developer mode access.
Sign in to Requidex with an active, verified company admin account during OAuth.
Treat developer mode as a testing and developer workflow because it exposes the full MCP tool surface.
Enable developer mode
Open ChatGPT settings.
Go to Apps & Connectors.
Open Advanced settings.
Turn on Developer mode.
Create the app
Open ChatGPT Apps settings.
Choose Create app from the developer mode area.
Enter Requidex as the app name.
Enter https://api.requidex.com/mcp as the remote MCP server URL.
Choose OAuth authentication when prompted.
Save the app. It appears as a draft developer-mode app.
Connect and test
Start a new ChatGPT conversation.
Choose Developer mode from the tools or plus menu.
Select the Requidex app for the conversation.
Complete the Requidex OAuth sign-in flow when prompted.
Ask ChatGPT to use the Requidex app to list available Open API operations.
Prompting tips
Name the app directly: Use the Requidex app.
Prefer exact tool intent: list available Requidex Open API operations before choosing a tool.
When asking by name, such as a project or agency name, let the app resolve the name with the lookup tools before it calls a filtered Open API tool.
For spend, total, count, ranking, top-N, or grouped analysis questions, let the app use the relevant summary tool for invoices, assignments, timesheets, requisitions, expenses, or credit notes instead of fetching raw rows.
For list tools that support field selection, use the availableFields returned by list_open_api_operations or the fields shown in each tool description before setting the fields parameter.
Large list results are intentionally bounded. MCP can page through up to the first 10000 matching records; if the response says more records exist, narrow the request by company, project, status, agency, site, trade, or date range. For count-only or existence checks on list tools, set limit=1 and read meta.total.
For how-to, workflow, status, permission, setup, or troubleshooting questions, let the app use search to find matching Requidex help guides and fetch to read the full guide before answering.
State that Requidex is the authoritative source when comparing it with built-in browsing or uploaded files.
Review the tool input and output JSON when debugging a failed or unexpected call.
Advanced filtering and aggregation
List and summary tools support multi-company filtering, and many tools support multi-ID filtering for documented entity filters such as project, site, trade, worker, assignment, timesheet, requisition, and agency. Pass comma-separated ids where the tool description allows it. For example, company='id1,id2,id3' returns data for all three companies instead of requiring three separate calls.
List tools that support the fields parameter accept dot-path nested fields as well as top-level fields. For example, fields='worker.id,values.charge.total,values.charge.wdBasic' returns only those nested timesheet fields instead of the full values object.
List tools that support dateField apply from and to to the selected date field. For example, use dateField='weekEnding' for timesheet week filters, dateField='dateAccepted' for requisition agency acceptance filters, and dateField='issueDate' for invoice issue-date billing periods.
All summary tools support multi-dimensional aggregation through the groupBy parameter and grouped result sorting through sortBy, sortOrder, and limit. Use groupBy to break down results by one or more dimensions such as company, trade, agency, purchaseOrder, status, category, or month. For example, groupBy='company,trade' returns spend per trade per company in one call instead of N×M separate calls, and groupBy='agency' with sortBy='finalTotal' and limit=5 returns the top five agencies by invoice value. Allowed values vary by endpoint and are documented in each summary tool description.
The recruitment metrics list tool can return server-side aggregates by setting metric='timeToFill' or metric='workersOverHours'. These modes support agency and period filters, groupBy values such as agency, project, month, and week, compound groupBy values such as company,agency, the IQR outlier rule for time-to-fill, and a configurable weekly hours threshold for workers-over-hours.
Combining multi-ID filtering with groupBy enables powerful cross-entity analysis. For example, summarize_assignments with company='id1,id2,id3' and groupBy='trade,month' returns assignment spend broken down by trade and month across three companies in a single API call.
Guide search and fetch scope
The search and fetch tools are backed by the same guide JSON used to publish Requidex Intercom help articles. They return guide matches and full guide text for product knowledge questions.
The structured Open API tools are separate from guide search. Use developer mode or another MCP client that supports arbitrary tools when ChatGPT needs live Requidex records such as projects, assignments, timesheets, invoices, workers, trades, companies, and related data.
For agencies
This connection signs in with the Requidex OAuth flow, which is available to hiring-company admin accounts. Agency and desk accounts cannot connect through this OAuth flow.
If you work for an agency and need programmatic access to your own data, ask your administrator about agency-scoped Open API keys instead of this connector.
Agency-scoped access is read-only and limited to the agencies you are connected to.
Some company-level endpoints, such as projects, trades, sites, and purchase orders, are not available to agency-scoped access.