# **TendersAlerts — Saudi Government Tenders | MCP Connector** Connect your TendersAlerts account to Claude, ChatGPT, Perplexity, Grok, or any other MCP-compatible AI chat assistant, and search, analyse and manage Saudi government tenders directly from the conversation. ## **1. What this connector does** Once your account is connected, the assistant can: - Search Saudi government tenders, filtering by city, activity, agency, tender type and date. - Read the details of a specific tender: owning agency, key dates, contract duration, warranties, SME preference, and the AI summary. - Retrieve the technical specification document (TSD), evaluation criteria, attachment list, and bill of quantities (BOQ). - Analyse the market: concentration, year-on-year trend, competition levels, and median award values. - Analyse a specific vendor's performance: proposals, awards, win rate, price positioning, and how they compare against the vendors who bid on the same tenders. - Read your notification settings, and create, update and archive them. Platform content is primarily Arabic. Some fields can be requested in English via the `locale` parameter. ## **2. Before you connect** RequirementDetailsA TendersAlerts accountFree or subscribed — [create one](https://tendersalerts.com)An active subscriptionRequired for nine of the eleven tools (see section 4)An MCP-capable chat toolClaude, ChatGPT, Perplexity, Grok, or any other chat assistant supporting MCP over Streamable HTTPAll subscription plans give identical connector access; plans differ only in duration. ## **3. How to connect** **Server URL:** `https://api.tendersalerts.com/mcp `The connector is a standard remote MCP server over Streamable HTTP with OAuth 2.1. It works with any MCP-compatible chat assistant — Claude, ChatGPT, Perplexity, Grok, and others. Setup is the same everywhere: paste the server URL, then complete the sign-in. **Claude** - Open **Settings → Connectors**. - Choose **Add custom connector**. - Paste the server URL above. - Click **Connect** — a TendersAlerts authorization page will open. - Sign in and grant permission. **ChatGPT** - Open **Settings → Connectors → Advanced** and enable **Developer mode**. This requires a paid ChatGPT plan; it is not available on Free. - Go to **Settings → Connectors** and create a new custom connector. - Paste the server URL and choose **OAuth** if prompted for an authentication method. - Save, then start a new chat and enable the connector from the tools menu. - Complete the TendersAlerts sign-in when redirected. On Business and Enterprise workspaces, an admin may need to enable custom connectors first. **Other chat assistants** Other MCP-compatible chat assistants — including Perplexity and Grok — each have their own way of adding a remote server, but all of them need the same two things: the server URL above, and Streamable HTTP as the transport. Consult your assistant's documentation for where to enter them. **How authorization works:** the connection uses OAuth 2.1 with PKCE, and supports Dynamic Client Registration, so clients can register themselves without a pre-shared key. Your username and password are never sent to the tool — only an access token linked to your account. **Revoking access:** from your account settings on the platform, or from the connector settings in the tool itself. Access stops immediately. Every tool, including the free ones, requires signing in to a TendersAlerts account. Search and taxonomy lookup don't require an active subscription, but — like every other tool — they do require a connected account first. ## **4. Available tools** ToolWhat it doesAccess`search-tenders`Search tenders with filtering, sorting and paginationFree`taxonomy-lookup`Resolve a name (city, activity, agency, type, region, vendor) to an IDFree`tender-details`Core details for a single tenderSubscriber`tender-documents`TSD, criteria, attachments, BOQ summary, AI summarySubscriber`tender-boq`Page through the rows of a specific BOQ tableSubscriber`market-analysis`Market-wide analysis: overview, concentration, trend, competitionSubscriber`vendor-details`A specific vendor's performance and peer benchmarkSubscriber`notification-settings`Read your notification settingsSubscriber`create-notification-setting`Create a new notification settingSubscriber`update-notification-setting`Modify an existing settingSubscriber`archive-notification-setting`Archive, restore, activate or deactivate a settingSubscriber**The natural call order:** `taxonomy-lookup → search-tenders → tender-details → tender-documents → tender-boq ``taxonomy-lookup` turns names into IDs, `search-tenders` returns reference numbers, and every other tool works from a reference number. **Two things worth knowing:** - Notification keywords (`keywords_include`, `keywords_exclude`) are matched against the Arabic tender text, so English keywords will not match — except for product names and part numbers, which appear as-is in BOQ text and need `includes_boq: true`. - Searching in Arabic and English can return different results, because `locale` sets both the search corpus and the response language. ## **5. Example prompts** **Search and filter** > Find open tenders in Riyadh in the IT activity, sorted by the soonest submission deadline. **Read a tender in depth** > Show me the details of tender 260839002113, then summarise the technical specification and the bill of quantities. **Analyse a competitor** > Analyse vendor name's performance in construction tenders across 2025 and 2026: win rate, price positioning, and who they compete against most. **Analyse the market** > How concentrated is the cybersecurity tender market? Show concentration and the year-on-year trend. **Manage notifications** > Show my notification settings, then create a new one for IT tenders in Riyadh region with the keyword "أمن سيبراني". ## **6. Usage limits** Limits are per account under Article (11) of the Terms of Use, and both a monthly and a daily limit apply together: TypeMCP tender searchesTotal MCP tool usesSubscribers · monthly5,00040,000Subscribers · daily4002,500Non-subscribers · monthly50500Non-subscribers · daily325When a limit is reached, the tool returns a message naming the limit that was hit and how long until you can retry. `initialize` and `tools/list` are not counted against any limit. If your usage needs higher limits, contact [care@tendersalerts.com](mailto:care@tendersalerts.com). ## **7. Common errors** MessageCauseFixThis tool requires an active subscriptionThe tool is subscriber-only[Subscribe](https://tendersalerts.com/plans), or check you connected the right accountRate limit reachedOne of the limits in section 6 was exceededWait the period stated in the messageID not foundAn invalid city / activity / agency IDUse `taxonomy-lookup` to resolve the correct IDInvalid date rangeA non-existent date, or `from` after `to`Correct the dates, in YYYY-MM-DD formatWhen several IDs are passed in one filter, any that don't exist are dropped and reported in `errors`, as long as at least one valid ID remains. If every ID in that filter is invalid, the call fails rather than returning a misleading result. ## **8. Data and privacy** - The tool you connect can read the tender data available to your account, and read your notification settings and their associated email address. - It can also **create, update and archive** your notification settings. Approving the connection grants this alongside read access. - It **cannot** access your password, payment data, or identity verification documents. - Once data reaches the tool you chose, it is governed by that provider's privacy policy. - We log requests received through the connector for security purposes and to verify usage limits. Full details in our [Privacy Policy](https://tendersalerts.com/en/legal/privacy-policy), Article 7.3. ## **9. Support** [care@tendersalerts.com](mailto:care@tendersalerts.com) **Evotik Innovations FZ-LLC**