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-vaas-en/mcp

Standard setup for AI tools providing an mcp.json file

{
  "publicacao-vagas-vaas-en MCP server": {
    "url": "https://vaas.vag.as/doc/publicacao-vagas-vaas-en/mcp"
  }
}

GET /dominios/paises/{pais_id}/estados/{estado_id}/cidades

O auth2

Path parameters

pais_id integer Required

Identificação do país
estado_id integer Required

Identificação do estado

Query parameters

nome string

busca pelo nome da cidade
nome_exato boolean

busca pelo nome exato da cidade
descricao string

busca pela descrição da cidade

Responses

200 application/json

OK
Hide response attributes Show response attributes object
- id integer
- nome string
- descricao string
- latitude number
- longitude number
- lat number
- lng number
- capital boolean
- estado_id integer
- pais_id integer

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
  }
]