MCP ogłoszenia API
Publiczna dokumentacja integracji MCP dla ogłoszeń miastoo.pl. Ta strona nie pokazuje prywatnych tokenów niezalogowanym użytkownikom.
Endpoint i autoryzacja
POST /api/mcp_ogloszenia.php
Content-Type: application/json
Accept: application/json, text/event-stream
Authorization: Bearer <TOKEN_UZYTKOWNIKA>Narzędzia
- list_listings - lista własnych ogłoszeń.
- get_listing - szczegóły własnego ogłoszenia.
- create_listing - tworzenie ogłoszenia z limitem, zdjęciami i wykrywaniem duplikatów.
- update_listing - edycja pól zgodnych z formularzem ogłoszenia.
- archive_listing - archiwizacja bez trwałego usuwania.
- get_quota - dzienny limit i bieżące zużycie.
Lokalizacja ogłoszenia
create_listing wymaga location.miejscowosc i location.ulica. Serwer uzupełnia slug miejscowości, województwo, powiat i gminę z lokalnego katalogu TERYT, gdy miejscowość jest jednoznaczna.
{
"location": {
"miejscowosc": "Wrocław",
"ulica": "ul. Paczkowska 13",
"dzielnica": "Huby"
}
}Limity i błędy
Domyślny limit to 100 nowych ogłoszeń dziennie na użytkownika. Administrator może ustawić limit globalny i indywidualny. Typowe kody błędów: unauthorized, token_expired, forbidden, validation_error, limit_exceeded, duplicate_detected, photo_invalid.
Przykład bez sekretów
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_quota",
"arguments": {}
}
}