ausdata-mcp-client CLAUDE.md

ausdata-mcp — TypeScript MCP client

One-line value prop: public MCP server that routes AI-agent tool calls to the hosted ausdata.io REST API.

License: MIT. Distribution: public npm (when published).

CRITICAL — distinction from ausdata-mcp (Python)

This repo is NOT the private bundle. There are two related packages and they must never be conflated:

Package	Language	Distribution	Purpose
ausdata-mcp (Python, private)	Python / FastMCP	Internal only — DO NOT PUBLISH	Direct sister-MCP imports, commercial moat, sold as enterprise self-host
ausdata-mcp (TypeScript, THIS REPO)	TypeScript / MCP SDK	Public npm under @ausdata org	Routes to hosted API; free entry-point for AI agent devs

If you find yourself reading from /Users/harry/Desktop/MCP Endpoint Creation/ausdata-mcp/, you are in the WRONG repo for this work. The private bundle lives there. This repo (ausdata-mcp-client/) is the public TypeScript client.

TypeScript + MCP SDK rationale

• TypeScript matches the audience: Claude Code / Cursor / Windsurf devs already have node + npm. npx ausdata-mcp is friction-free.
• The @modelcontextprotocol/sdk TS implementation is the reference client; stays compatible with all transports.
• HTTP routing only — zero parsing — keeps this client trivial to maintain. New endpoints in the REST API need a new tool file, that's it.

Architecture

src/
├── index.ts        main() entry point
├── server.ts       MCP Server bootstrap (stdio transport)
├── client.ts       HTTP client → api.ausdata.io (override via AUSDATA_BASE_URL)
├── config.ts       env var loading
├── tools/          one file per MCP tool
│   ├── index.ts    registry (source of truth; 21 tools)
│   └── <one .ts file per tool>  (search-datasets, list-datasets, describe,
│        get-data, health, real-wages, economic-dashboard, and 14 more)
└── lib/
    ├── errors.ts   ApiError + mcpError + toMcpError
    └── format.ts   mcpJson — wrap any JSON in MCP content