find_tools
ChatGPTStart here when unsure which Tendios tool to use. Describe the task in English or Spanish; returns a small set of registered tools, exact input schemas, prerequisites and a suggested sequence. Read-only discovery: does not execute tools or resolve entity names. Existing authorization and confirmation requirements still apply.
get_alert
ChatGPTGet the current configuration of one alert by its Tendios URL or alert reference. Use a reference from list_alerts. For matching tenders use get_alert_results instead.
get_alert_results
ChatGPTGet tenders matching one of your saved alerts, with references for retrieving a selected tender. Resolve the alert reference with list_alerts first; this returns matching tenders, while get_alert returns alert configuration.
get_cpv
ChatGPTGet the details of a CPV (Common Procurement Vocabulary) code, e.g. 72000000. Use a CPV code from tender details or an explicit user-provided code.
get_kanban_opportunities_by_status
ChatGPTGet a paginated list of opportunities in a specific pipeline status (kanban column). Obtain the pipeline and stage references from list_pipelines or get_kanban_status_totals first.
get_kanban_status_totals
ChatGPTGet opportunity totals and machine-readable status references for a kanban board in your account. Resolve the pipeline using list_pipelines first. For individual opportunities use get_kanban_opportunities_by_status or search_kanban_opportunities.
get_market_awards
ChatGPTCount and list awarded tenders, with totals, for a supplier family, a buyer, or both. Supplier side: supplierFamilyId from list_market_scopes, or omit it for any supplier. Buyer side: buyerPerimeterId from list_market_scopes, or buyerOrganizationId from search_organizations (by default its dependent bodies are included, e.g. every department of a regional government), or omit both for all buyers. At least one of supplierFamilyId, buyerPerimeterId or buyerOrganizationId is required. For a whole country omit the buyer and use countryCode ES for Spain. For "awarded in <year>" use awardedFrom/awardedTo (award date); publishedFrom/publishedTo filter publication date. One complete range is required. Read summary.totalContracts for the count across all pages. Excludes modification records unless includeModifications=true. Ask for the period when unspecified.
get_opportunity_workflow_actions
ChatGPTGet the current workflow action records for an opportunity in your account, grouped by workflow step. Resolve the opportunity using search_kanban_opportunities first. Reads recorded workflow actions; does not execute them.
get_organization
ChatGPTGet an organization profile by its id (e.g. the contractingOrganizationId of a tender) or its slug, e.g. altia-consultores-sa. Resolve names with search_organizations first; use its returned ID or slug, never guess one. This retrieves one operational record, not a supplier family.
get_organization_award_stats
ChatGPTGet yearly and sector statistics for awards issued by a buyer or won by a supplier (selected from the organization type), identified by its id (e.g. the contractingOrganizationId of a tender) or its slug. First resolve the exact entity with search_organizations. These statistics cover one operational organization; for a corporate family, date range or country-filtered total use list_market_scopes then get_market_awards.
get_tender
ChatGPTRetrieve the full details of a single tender by its id: budget, estimated value, award amount, recorded awardee, contracting system and parent framework agreement or dynamic purchasing system, and each lot with its awardee and award amount. Use a tender ID returned by search_tenders, get_alert_results, or get_market_awards. For its documents call get_tender_sheets; for all bidders and their offers, get_tender_candidates.
get_tender_candidates
ChatGPTBidders of one or several tenders (up to 25 per call) as structured data: company, tax ID, offered amount, discount (baja), total score, position, whether it won, exclusions or withdrawals with their reason, per lot. Tendios extracts them from the award minutes (actas) once published, so recent or unprocessed tenders may have none; scores per criterion are not extracted yet (read the minutes with read_tender_sheet using the listed Sheet IDs). Use tender IDs from search_tenders.
get_tender_questions
ChatGPTClarification questions asked by bidders during a tender and the answers of the contracting authority, newest first, as published by sources that support them (e.g. Plataforma de Contratación del Sector Público, Plataforma de Contractació Pública de Catalunya). Use a tender ID from search_tenders.
get_tender_sheets
ChatGPTList the documents of one or several tenders (up to 25 per call; prefer one call with several IDs over many calls): name, document type (pliegos, informe de valoración, acta, adjudicación...), source, date, whether the source has withdrawn it, a Tendios download link valid 15 minutes, and a Sheet ID to read its text with read_tender_sheet. Use tender IDs from search_tenders, get_tender or get_market_awards.
list_alerts
ChatGPTList all configured alerts for the authenticated Tendios account, with references for retrieving their results. Start here when an alert reference is unknown. Use get_alert for configuration or get_alert_results for matching tenders.
list_market_scopes
ChatGPTList active curated supplier families and buyer perimeters. Use the returned IDs with get_market_awards. Start here for corporate-family award questions, even when starting from a company name. Drafts are excluded. For a whole country, get_market_awards accepts countryCode without a buyer perimeter. Never substitute a regional perimeter for the whole country.
list_opportunity_tasks
ChatGPTList tasks associated with an opportunity in your Tendios account, optionally by status. Resolve the opportunity using search_kanban_opportunities first; this reads tasks and does not create them.
list_pipelines
ChatGPTList the opportunity pipelines and stages configured for your account, including the IDs required by the kanban tools. Start here when a pipeline or stage ID is unknown; use search_kanban_opportunities to find an opportunity.
read_tender_sheet
ChatGPTRead the text of a tender document (pliegos, informes de valoración, actas, resoluciones...) as markdown, extracted by Tendios from the PDF or office file, including tables. Use a Sheet ID from get_tender_sheets. Long documents come in pages of 40,000 characters: keep calling with the next page until there are no more. Scanned images without text may be incomplete.
search_kanban_opportunities
ChatGPTSearch opportunities within a pipeline, grouped by status. Returns up to limit opportunities per status and references for status-specific pagination. Use this to resolve an opportunity reference before reading its tasks, workflow actions or changing its stage.
search_organizations
ChatGPTResolve an organization name or tax ID to existing organization IDs and alias slugs. Use before get_organization or get_organization_award_stats; never guess slugs. Returns separate operational records, not a consolidated supplier family. For awards across a corporate family use list_market_scopes then get_market_awards. If matches are ambiguous, show their names, tax IDs and countries before choosing.
search_registry_units
ChatGPTResolve a public authority by name, code or tax ID to its official unit; pass its country, Spain by default. Use the unit IDs in search_tenders contractingRegistryUnitIds: each unit includes every unit below it. Entities (the whole authority of a tax ID) come first; prefer them unless the user asks for a specific part.
search_tenders
ChatGPTFind who won tenders in a sector using CPV, awarded/formalized status and country filters; no supplier family is required. Search tenders by text and filters (status, CPVs, locations, budget, date ranges), with references for retrieving a selected tender. Returns recorded awardees when available; use get_organization with their IDs for details. Use contractingRegistryUnitIds for public authorities (from search_registry_units; it covers every organization record of the authority, so it is more complete than organization IDs), contractingOrganizationIds for other buyers, contractingSystems for specific contracts of an SDA or framework agreement, contractingOrganizationNames only when neither finds the buyer, successBidderOrganizationIds for suppliers, and minAwardingDate/maxAwardingDate for award periods. Text searches tender content, not awardee names. Results count tenders, not lots or award events; paginated results cannot provide complete supplier rankings. For curated supplier-family win counts use list_market_scopes then get_market_awards; for company lookup use search_organizations.
whoami
ChatGPTGet the authenticated principal (API key or signed-in connection), account, linked organization, and active Bid plan in context. Use for caller/account context and plan questions; does not expose API keys or credential-management details.