cdmngz/gov-salaries-mcp

Using this with ChatGPT (MCP)

• This project exposes a simple, read-only HTTP API suitable for Model Context Protocol (MCP) clients (e.g., ChatGPT). Requests must include an API key via header: x-api-key.

• Base URL

• https://d3oiieuprj.execute-api.eu-central-1.amazonaws.com

• Endpoints

• GET /mcp/health GET /mcp/listYears?country= GET /mcp/getRates?country=&year= GET /mcp/getDataset?country=&year=

• Required header

• x-api-key: <YOUR_PUBLIC_API_KEY>

• Quick tests (curl)

  # Health
  curl -sS -H "x-api-key: <KEY>" \
  

https://d3oiieuprj.execute-api.eu-central-1.amazonaws.com/mcp/health | jq

List available years for Spain

curl -sS -H "x-api-key: " \

"https://d3oiieuprj.execute-api.eu-central-1.amazonaws.com/mcp/listYears?country=es " | jq

Get currency rates

curl -sS -H "x-api-key: " \

"https://d3oiieuprj.execute-api.eu-central-1.amazonaws.com/mcp/getRates?country=es&year=2025 " | jq

Get dataset

curl -sS -H "x-api-key: " \

"https://d3oiieuprj.execute-api.eu-central-1.amazonaws.com/mcp/getDataset?country=es&year=2025 " | jq

Add as an MCP server in ChatGPT

ChatGPT → Settings → Connectors → Create → add your server.

• Minimum server configuration (example):
  • Server URL:

https://d3oiieuprj.execute-api.eu-central-1.amazonaws.com/mcp

• Auth header: x-api-key: <YOUR_PUBLIC_API_KEY>

• Tools exposed:

  • listYears(country)
  • getRates(country, year)
  • getDataset(country, year)

Example MCP manifest (reference)

{

"name": "gov-salaries-mcp",

"version": "0.1.0",

"description": "Read-only tools for querying public government salary datasets.",

"server": {

"url": "https://d3oiieuprj.execute-api.eu-central-1.amazonaws.com/mcp
",

"headers": { "x-api-key": "<YOUR_PUBLIC_API_KEY>" }

},

"tools": [

{

"name": "listYears",

"description": "List available dataset years for a country.",

"method": "GET",

"path": "/listYears",

"input": { "country": "string (ISO-2, e.g. es)" }

},

{

"name": "getRates",

"description": "Get currency rates for a country and year.",

"method": "GET",

"path": "/getRates",

"input": { "country": "string", "year": "number (YYYY)" }

},

{

"name": "getDataset",

"description": "Get the full dataset for a country and year.",

"method": "GET",

"path": "/getDataset",

"input": { "country": "string", "year": "number (YYYY)" }

}

]
}

Security & limits

• API is read-only; data source is public.
• Keep your key private; rotate it if leaked.
• Recommended: add WAF (rate-based) if you open sign-ups for keys.