`korea_get_awards`

Pack: korea-tenders · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/korea_get_awards for the schema, then POST the same URL with its arguments for the data.

BYOK. Korean public-procurement award results (winners, amounts) by type and date window; needs your own data.go.kr key.

Tool description as the model sees it

BYOK. Requires an API key: South Korean public-procurement AWARD results (who won which bid) from the Public Procurement Service successful-bid records, multi-year, not just the last 12 months. Pass your own free Korean public-data-portal (data.go.kr) service key as _apiKey; there is no platform key. Get one free by registering at https://www.data.go.kr and applying for the Public Procurement Service successful-bid information service. Filter by procurement type (goods, services, construction), award date window (max 31 days per call), notice number, winner-name text and notice-title text. Returns per award: notice number and title, buyer, winner name and business number, award amount in KRW, award rate, number of bidders, opening date. Example: korea_get_awards({ type: “services”, from: “2024-03-01”, to: “2024-03-31”, _apiKey: “your-key” })

Parameters

Name	Type	Required	Description
`type`	string	no	goods, services or construction (default services).
`from`	string	no	Award window start, YYYY-MM-DD.
`to`	string	no	Award window end, YYYY-MM-DD (at most 31 days after from).
`notice_no`	string	no	Look up one bid notice number instead of a date window.
`winner`	string	no	Keep only awards whose winner name contains this text (Korean, as registered).
`title`	string	no	Keep only awards whose notice title contains this text (Korean).
`limit`	number,string	no	Max awards to return (default 20, max 100).
`page`	number,string	no	Upstream page, 1-based (each page is up to 100 records before the winner/title filter).
`_apiKey`	string	yes

Example call

Arguments

{
  "type": "services",
  "from": "2024-03-01",
  "to": "2024-03-31",
  "limit": 5
}

curl

curl -X POST https://gateway.pipeworx.io/korea-tenders/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"korea_get_awards","arguments":{"type":"services","from":"2024-03-01","to":"2024-03-31","limit":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('korea_get_awards', {
  "type": "services",
  "from": "2024-03-01",
  "to": "2024-03-31",
  "limit": 5
});

Response shape

Field	Type	Description
`source`	string
`data_as_of`	string
`type`	string
`window`	object
`page`	number
`upstream_total`	number \| null
`upstream_page_records`	number
`count`	number
`awards`	array
`note`	string \| null

Full JSON Schema

{
  "type": "object",
  "additionalProperties": true,
  "properties": {
    "source": {
      "type": "string"
    },
    "data_as_of": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "window": {
      "type": "object",
      "additionalProperties": true
    },
    "page": {
      "type": "number"
    },
    "upstream_total": {
      "type": [
        "number",
        "null"
      ]
    },
    "upstream_page_records": {
      "type": "number"
    },
    "count": {
      "type": "number"
    },
    "awards": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "notice_no": {
            "type": [
              "string",
              "null"
            ]
          },
          "notice_order": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "buyer": {
            "type": [
              "string",
              "null"
            ]
          },
          "winner": {
            "type": [
              "string",
              "null"
            ]
          },
          "winner_business_no": {
            "type": [
              "string",
              "null"
            ]
          },
          "winner_representative": {
            "type": [
              "string",
              "null"
            ]
          },
          "award_amount_krw": {
            "type": [
              "number",
              "null"
            ]
          },
          "award_rate_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "bidders": {
            "type": [
              "number",
              "null"
            ]
          },
          "opened_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "award_date": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "note": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the korea-tenders pack

{
  "mcpServers": {
    "korea-tenders": {
      "url": "https://gateway.pipeworx.io/korea-tenders/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

korea_get_awards