v0.4.0 · 21 tools

API Reference

Every tool, every parameter. Jump to a section: Search · Details · Buyers · Suppliers · Analytics · Alerts · Export

Tender & Award Details · 2 tools

Tender & Award Details

get_tender

Get full details of a specific tender by ID, including description, buyer, category, value range, and any related awards.

ParameterTypeRequiredDescription
idnumberYesTender ID
"Get full details for tender #54321"

get_award

Get full details of a specific contract award by ID, including supplier, buyer, value, and contract dates.

ParameterTypeRequiredDescription
idnumberYesAward ID
"Show me the details of award #9876"

Buyer Intelligence · 3 tools

Buyer Intelligence

search_buyers

Search government buyers and agencies by name or jurisdiction. Returns tender counts and total award values.

ParameterTypeRequiredDescription
querystringNoSearch buyer name
jurisdictionstringNoFilter by jurisdiction
limitnumberNoMax results (default 20, max 50)
offsetnumberNoOffset for pagination
"Find all Queensland government health agencies"

get_buyer

Get a detailed buyer profile including tender/award statistics, top categories, yearly spending trends, and recent activity.

ParameterTypeRequiredDescription
idnumberYesBuyer ID
"Give me a full profile of the Department of Defence including spending trends"

get_buyer_awards

Get full paginated award history for a buyer/agency with rich filtering. Essential for understanding spending patterns.

ParameterTypeRequiredDescription
buyer_idnumberYesBuyer ID
from_datestringNoAwards from date (YYYY-MM-DD)
to_datestringNoAwards to date (YYYY-MM-DD)
supplier_namestringNoFilter by supplier name
min_valuenumberNoMinimum award value
max_valuenumberNoMaximum award value
jurisdictionstringNoFilter by jurisdiction
limitnumberNoMax results (default 20, max 100)
offsetnumberNoOffset for pagination
sort_bystringNoawarded_date or value
sort_orderstringNoasc or desc (default: desc)
"Show all contracts awarded by the ATO over $1M in the past year"

Supplier Intelligence · 3 tools

Supplier Intelligence

search_suppliers

Search government contract suppliers by name or ABN. Returns award counts and total value.

ParameterTypeRequiredDescription
querystringNoSearch supplier name
abnstringNoSearch by ABN (exact or partial)
limitnumberNoMax results (default 20, max 50)
offsetnumberNoOffset for pagination
"Look up the supplier with ABN 51 194 660 183"

get_supplier

Get a detailed supplier profile including top buyers, jurisdiction breakdown, category breakdown, yearly trends, and recent awards.

ParameterTypeRequiredDescription
idnumberYesSupplier ID
"Give me a competitive profile for Accenture including their government contract history"

get_supplier_awards

Get full paginated award history for a supplier with rich filtering. Essential for competitive analysis and win-rate tracking.

ParameterTypeRequiredDescription
supplier_idnumberYesSupplier ID
from_datestringNoAwards from date (YYYY-MM-DD)
to_datestringNoAwards to date (YYYY-MM-DD)
buyer_namestringNoFilter by buyer name
min_valuenumberNoMinimum award value
max_valuenumberNoMaximum award value
jurisdictionstringNoFilter by jurisdiction
limitnumberNoMax results (default 20, max 100)
offsetnumberNoOffset for pagination
sort_bystringNoawarded_date or value
sort_orderstringNoasc or desc (default: desc)
"Show me all Defence contracts won by this supplier in the last 3 years"

Market Analytics · 3 tools

Market Analytics

get_market_stats

Get aggregate market statistics including total tenders/awards, values, top buyers, top suppliers, and jurisdiction breakdown.

ParameterTypeRequiredDescription
jurisdictionstringNoFilter by jurisdiction
categorystringNoFilter by category (partial match)
from_datestringNoFrom date (YYYY-MM-DD)
to_datestringNoTo date (YYYY-MM-DD)
"Give me a market overview of Victorian IT procurement in 2025"

list_jurisdictions

List all Australian jurisdictions with tender count and last update time. No parameters required.

"What jurisdictions does AskTender cover and how many tenders are in each?"

list_categories

List all available tender categories with counts. Useful for discovering what category values to use in search filters.

ParameterTypeRequiredDescription
jurisdictionstringNoFilter categories by jurisdiction
limitnumberNoMax results (default 50)
"What tender categories are available for federal tenders?"

Alerts & Watches · 4 tools

Alerts & Watches

Save search criteria and receive automated email briefings at 7:00 AM AEST when new tenders or awards match. Requires authentication.

create_watch

Create a saved search alert with custom filters for tenders or awards.

ParameterTypeRequiredDescription
namestringYesName for this watch (e.g. "NSW IT Tenders")
descriptionstringNoOptional description
watch_typestringNotender (default) or award
keywordsstringNoKeywords to match
jurisdictionstringNoFilter by jurisdiction
categorystringNoFilter by category
statusstringNoFilter by tender status
min_valuenumberNoMinimum value filter
max_valuenumberNoMaximum value filter
"Set up an alert called 'Big NSW Construction' for NSW construction tenders over $5M"

list_watches

List all your saved search alerts with their filters, status, and last run time. No parameters required.

"Show me all my saved alerts"

update_watch

Update an existing watch — change name, filters, or pause/resume it.

ParameterTypeRequiredDescription
idnumberYesWatch ID to update
namestringNoNew name
keywordsstringNoUpdate keywords
jurisdictionstringNoUpdate jurisdiction
categorystringNoUpdate category
statusstringNoUpdate status filter
min_valuenumberNoUpdate min value
max_valuenumberNoUpdate max value
activebooleanNofalse to pause, true to resume
"Pause my alert #5 and change the minimum value to $2M"

delete_watch

Delete or deactivate a saved search alert.

ParameterTypeRequiredDescription
idnumberYesWatch ID to delete
deactivate_onlybooleanNoIf true, pauses instead of deleting
"Delete my saved alert #3"

Export · 2 tools

Export

export_tenders_csv

Export tender search results as CSV. Same filters as search_tenders but with a higher limit of up to 500 rows.

ParameterTypeRequiredDescription
querystringNoFull-text search query
jurisdictionstringNoFilter by jurisdiction
statusstringNoFilter by status
from_datestringNoClosing date from (YYYY-MM-DD)
to_datestringNoClosing date to (YYYY-MM-DD)
categorystringNoFilter by category
buyer_namestringNoFilter by buyer name
limitnumberNoMax rows (default 100, max 500)
"Export all Victorian open tenders as a CSV"

export_awards_csv

Export award search results as CSV. Same filters as list_awards but with a higher limit of up to 500 rows.

ParameterTypeRequiredDescription
jurisdictionstringNoFilter by jurisdiction
from_datestringNoAwarded from (YYYY-MM-DD)
to_datestringNoAwarded to (YYYY-MM-DD)
supplier_namestringNoFilter by supplier name
querystringNoSearch award titles
limitnumberNoMax rows (default 100, max 500)
"Export all federal awards from the past 6 months as CSV"

Documentation

Explore tenders

Frequently asked questions

How many tools does the AskTender MCP have?+

AskTender v0.4.0 exposes 21 tools across 7 categories: search and discovery, tender and award details, buyer intelligence, supplier intelligence, market analytics, alerts and watches, and CSV export.

Do I need to know the tool names to use AskTender?+

No. Just ask natural language questions like 'find NSW IT tenders over $500K' and your AI (ChatGPT or Claude) automatically selects and calls the right tools. The API reference is here for developers and advanced users.

What parameters are required vs optional?+

Most tools have no required parameters — you can call search_tenders with no filters to browse all open tenders. Tools that operate on a specific record (like get_tender or get_buyer) require an ID. Required parameters are marked in the tables above.

What is the maximum number of results per request?+

Search tools return up to 50 results per request (default 20). CSV export tools support up to 500 rows. All search tools support offset-based pagination to retrieve additional pages.

Do alerts and watches require authentication?+

Yes. The create_watch, list_watches, update_watch, and delete_watch tools require an authenticated API key linked to a user account. Sign up at asktender.com.au to get your free key.

Ready to try these tools?

Every Australian government tender, live in ChatGPT and Claude. First 25 requests free.

25 free requests · No credit card · Cancel anytime