BuyICT MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BuyICT MCP Server search for cloud computing opportunities in the Cloud Marketplace"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BuyICT MCP Server
A Model Context Protocol (MCP) server that provides Claude with access to Australian Government ICT procurement opportunities from BuyICT.
Features
π Search procurement opportunities across multiple marketplaces
π Get detailed information about specific opportunities
πͺ List available marketplaces (PCS, SMP, CMP, LH, TMP, DC, HMP)
π Supports authenticated access to BuyICT ServiceNow instance
Related MCP server: gets-nz
Installation
Clone this repository or navigate to the project directory:
cd buyict_mcpInstall dependencies:
npm installBuild the TypeScript code:
npm run buildConfiguration
1. Environment Variables
Copy the example environment file and fill in your credentials:
cp .env.example .env2. Obtaining Session Credentials
To access BuyICT data, you need to provide session credentials from your browser:
Open https://www.buyict.gov.au in your browser
Log in (if required for the opportunities you want to access)
Open Developer Tools (F12)
Go to the Network tab
Navigate to the Opportunities page or refresh it
Look for a request to
/api/now/sp/page?id=opportunitiesClick on it and go to the Headers section
Find and copy the following values to your
.envfile:
From the Cookie header:
JSESSIONIDβBUYICT_SESSION_IDglide_user_routeβBUYICT_GLIDE_USER_ROUTEglide_node_id_for_jsβBUYICT_GLIDE_NODE_IDVALK_SESSION_IDβBUYICT_VALK_SESSION_ID
From request headers:
X-UserTokenβBUYICT_USER_TOKENUX-TokenβBUYICT_UX_TOKEN
Note: These tokens expire after some time. If you get authentication errors, you'll need to refresh them by repeating this process.
Usage with Claude Desktop
Add the server to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"buyict": {
"command": "node",
"args": ["/absolute/path/to/buyict_mcp/dist/index.js"],
"env": {
"BUYICT_SESSION_ID": "your_session_id_here",
"BUYICT_USER_TOKEN": "your_user_token_here",
"BUYICT_UX_TOKEN": "your_ux_token_here"
}
}
}
}Or, to load from your .env file, use a wrapper script.
Restart Claude Desktop
The server will now be available with the following tools:
Available Tools
search_opportunities
Search for procurement opportunities with optional filters.
Parameters:
keyword(string, optional): Search term to filter opportunitiesmarketplace(string, optional): Filter by marketplace code (PCS, SMP, CMP, LH, TMP, DC, HMP)page_size(number, optional): Results per page (default: 15, max: 100)page(number, optional): Page number (default: 1)
Example:
Search for cloud computing opportunities in the Cloud Marketplaceget_opportunity_details
Get detailed information about a specific opportunity.
Parameters:
opportunity_id(string, required): The sys_id of the opportunitytable(string, required): Source table name (e.g., u_cmp_procurement)
Example:
Get details for opportunity ID abc123 from the u_cmp_procurement tablelist_marketplaces
Get a list of all available marketplaces.
Example:
Show me all available BuyICT marketplacesMarketplaces
The server supports the following BuyICT marketplaces:
Code | Name | Table |
PCS | Panel & Catalogue Services | u_pcs_procurement |
SMP | Software Marketplace | u_smp_procurement |
CMP | Cloud Marketplace | u_cmp_procurement |
LH | Labour Hire | u_lh_procurement |
TMP | Telecommunications Marketplace | u_tmp_procurement |
DC | Data Centre | u_dc_procurement |
HMP | Hardware Marketplace | u_hmp_procurement |
Development
Project Structure
buyict_mcp/
βββ src/
β βββ index.ts # MCP server entry point
β βββ servicenow-client.ts # ServiceNow API client
β βββ types.ts # TypeScript type definitions
βββ config/
β βββ buyict-config.json # Server configuration
βββ dist/ # Compiled JavaScript (generated)
βββ package.json
βββ tsconfig.json
βββ .env.example
βββ README.mdBuilding
npm run buildDevelopment Mode (with watch)
npm run devTesting
Start the server manually to test:
npm startCurrent Limitations
β οΈ Important: The current implementation has some limitations due to the ServiceNow Service Portal architecture:
Data Fetching: The
search_opportunitiestool currently returns the initial page structure but may not include actual opportunity data. This is because:ServiceNow widgets load data asynchronously via server-side scripts
The exact API endpoint for fetching opportunity data needs further investigation
May require authenticated access for full data access
Authentication: Session tokens expire and need to be manually refreshed from your browser.
Future Improvements Needed:
Discover the correct API endpoint for fetching opportunity listings
Implement automatic session refresh
Add caching to reduce API calls
Support more advanced filtering options
API Documentation
See these files for more details:
API_FINDINGS.md- Detailed API analysis and findingsAUTHENTICATION_ANALYSIS.md- Authentication mechanisms and requirementsMCP_SERVER_DESIGN.md- Architecture and design decisions
Troubleshooting
"User Not Authenticated" Error
This means your session tokens have expired. Follow the Configuration steps to get new tokens from your browser.
No Opportunities Returned
The search endpoint may require further implementation. Check the server logs for details. You may need to access opportunities directly via the website or investigate additional API endpoints.
Connection Issues
Ensure:
You have internet connectivity
BuyICT website is accessible
Your tokens are valid and not expired
Contributing
This is a work in progress. Contributions are welcome, especially:
Discovering the correct API endpoints for opportunity data
Implementing automatic authentication
Adding more filtering and search capabilities
Improving error handling
License
MIT
Disclaimer
This is an unofficial tool and is not affiliated with or endorsed by the Australian Government Digital Transformation Agency or BuyICT. Use responsibly and in accordance with BuyICT's terms of service.
Available Tools
3 toolsget_opportunity_detailsC
Get detailed information about a specific opportunity
Inputs: opportunity_id (required), table (required).
list_marketplacesB
Get list of available marketplaces/procurement types
Inputs: no named parameters.
search_opportunitiesC
Search for procurement opportunities on BuyICT with optional filters
Inputs: keyword, marketplace, page_size, page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: get_opportunity_details retrieves details for a specific opportunity, list_marketplaces provides available procurement types, and search_opportunities finds opportunities with filters. There is no overlap in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent verb_noun pattern using snake_case: get_opportunity_details, list_marketplaces, and search_opportunities. The verbs (get, list, search) are appropriate and uniformly applied, creating a predictable naming convention.
With only 3 tools, the set feels thin for a procurement domain that might require more operations like creating or updating opportunities. While the tools cover basic retrieval and listing, the count is borderline minimal for the apparent scope of a procurement server.
The tool surface is significantly incomplete for a procurement domain. It lacks essential CRUD operations such as create_opportunity, update_opportunity, or delete_opportunity, and does not include tools for managing bids or submissions. This will likely cause agent failures in full procurement workflows.
Maintenance
Related MCP Connectors
AusTender Australian government contract awards via OCDS. Free recent_contracts tool.
Find open Australian and NZ tenders and grants, match them to a company, and see who holds the work.
Search AU/NZ government tenders and rank a shortlist against company capabilities.
MCP access to the U.S. federal procurement graph: contracts, opportunities, entities, and more.
Related MCP Servers
- AlicenseAqualityFmaintenanceMatch your tech product or consulting service to thousands of live government tenders, RFPs, grants, and frameworks from 25+ official sources worldwide.455 npm6MIT
- AlicenseNot gradedqualityCmaintenanceProvides access to New Zealand Government Electronic Tenders Service (GETS) without API keys, enabling querying and searching for government tenders and contracts.132 npmMIT
- AlicenseNot gradedqualityBmaintenanceAccess Canada government procurement opportunities from CanadaBuys open data, enabling tender searches and procurement monitoring without an API key.89 npm1MIT
- AlicenseBqualityAmaintenanceEnables searching and filtering federal contract opportunities by keyword, agency, set-aside, NAICS, and more from any MCP client. Analyzes solicitations for small-business fit and risk, and provides reference lookups for NAICS codes, set-asides, and federal thresholds.9MIT