boamp

This MCP server provides access to the BOAMP public markets data. It exposes two main tools: get_public_markets to search for public market notices using criteria such as keywords, market type (SERVICES, TRAVAUX, FOURNITURES), a result limit, sort field, and departments; and get_market_details to fetch full details for a specific market by its idweb. To use the server, run it locally and connect via the MCP protocol over stdio, or integrate with Claude Desktop by configuring the server in your MCP client. Typical usage involves issuing a get_public_markets query with your desired keywords and filters, then optionally retrieving deeper information for any matching market with get_market_details using the market's idweb. You can also export results to CSV depending on client capabilities, as illustrated by the provided examples in the README.

When developing or debugging, you can use the MCP Inspector tool to inspect and debug the communication between the client and server. This server is built with Node.js, so you’ll interact with it via the Node runtime and the compiled build/index.js entry point.

Prerequisites:

• Node.js and npm installed on your system
• Access to the MCP server source repository (clone or download)

Step-by-step:

1. Install dependencies

npm install

2. Build the server

npm run build

3. (Optional) Enable auto-rebuild during development

npm run watch

4. Run the server locally (if not using a packaged build path)

node build/index.js

5. (Optional) Prepare Claude Desktop integration by adding the MCP server config in the Claude config file, for example:

{
  "mcpServers": {
    "boamp-server": {
      "command": "/path/to/boamp-server/build/index.js"
    }
  }
}

Tips:

• The server communicates over stdio; debugging can be challenging without tools like the MCP Inspector. Use npm run inspector to start the inspector and obtain a debugging URL.
• If you modify the server, rebuild with npm run build to ensure the latest changes are used by clients.
• When configuring for Claude Desktop, ensure the path to build/index.js is correct and that Node.js is available on the host running Claude Desktop.
• If you need to expose environment-specific settings (e.g., API endpoints, rate limits), consider using environment variables in the mcp_config under the env section for boamp-server.