publicacao-vagas-en

List Cities

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://vaas.vag.as/doc/publicacao-vagas-en/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "publicacao-vagas-en MCP server": {
    "url": "https://vaas.vag.as/doc/publicacao-vagas-en/mcp"
  }
}
Close
GET /dominios/paises/{pais_id}/estados/{estado_id}/cidades
O auth2

List all cities of a state or province

Path parameters

  • pais_id integer Required

    Country ID

  • estado_id integer Required

    State ID

Query parameters

  • nome string

    Search by the name of the city

  • nome_exato boolean

    Search by the exact name of the city

  • descricao string

    Search by the city's description

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • id integer
    • nome string

      Name

    • descricao string

      Description

    • latitude number
    • longitude number
    • lat number
    • lng number
    • capital boolean

      If the city is state capital

    • estado_id integer

      State ID

    • pais_id integer

      Country ID
GET /dominios/paises/{pais_id}/estados/{estado_id}/cidades 
curl \
 --request GET 'https://apigateway.vagas.com.br/v1/dominios/paises/999/estados/999/cidades' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
[
  {
    "id": 1,
    "nome": "Sao Paulo",
    "descricao": "Sao Paulo/SP/BR",
    "latitude": 1.5,
    "longitude": 1.8,
    "lat": 23.5475,
    "lng": 46.63611111111111,
    "capital": true,
    "estado_id": 128,
    "pais_id": 128
  }
]