# KharkovForum > KharkovForum is a Ukrainian community about Kharkiv: city life, news, housing, law, health, transport, technology and hobbies. Pages are in Ukrainian. This file is the long form of https://www.kharkovforum.com/llms.txt. It explains how to read the forum. It does not contain posts. Fetch posts live. Quote the thread title, post_date and view_url. Do not invent posts that are not in the response. There are two ways to read the forum. Use MCP if you can. Use the guest API only when you cannot speak MCP. ## MCP calls MCP does not use an API key. POST JSON-RPC to https://www.kharkovforum.com/mcp with Content-Type: application/json and Accept: application/json, text/event-stream. A browser GET returns 405. That is normal. Do not send XF-Api-Key to /mcp. The server is read-only. Tools: list_nodes, search (keywords), get_thread (thread_id), get_posts (thread_id, page). Start with initialize, then tools/list, then tools/call. Initialize: {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"example","version":"1.0.0"}}} Search, then open posts: {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search","arguments":{"keywords":"kharkiv"}}} {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_posts","arguments":{"thread_id":5508151,"page":1}}} search returns search_id, result_count and results. Each result has type (thread or post), id, thread_id, title, username and view_url. get_posts returns message text, 20 posts per page. The next page is page=2. If a post has files, the response includes attachments with attachment_id, filename and direct_url. Open direct_url as a normal link. It does not need an API key. list_nodes returns the public section tree. get_thread returns one thread's title and counters, without post text. ## Guest API The guest API needs a key on every request to https://www.kharkovforum.com/api/. Do not open https://www.kharkovforum.com/search/. Do not use GET /api/forums/{id}/threads/. XF-Api-Key: xZGZ27Y1tN-BqtijYWCGAGx-v6oqZ3B6 The key can read public sections, threads, posts and attachment files. It cannot create, edit or delete anything. How to read through the guest API: 1. GET https://www.kharkovforum.com/api/nodes/ for the section list. Use node_id, title and view_url. 2. Take thread IDs from that section's RSS: add index.rss to view_url, for example https://www.kharkovforum.com/forums/main/index.rss. A thread address looks like https://www.kharkovforum.com/threads/title.THREAD_ID/. 3. GET https://www.kharkovforum.com/api/threads/THREAD_ID/ for the title, dates and reply count. This response has no post text. 4. GET https://www.kharkovforum.com/api/threads/THREAD_ID/posts/?page=1 for the text. Read the message field. 20 posts per page. The next page is page=2. 5. If attach_count is greater than 0, the post includes Attachments. direct_url and thumbnail_url open without the API key. To download the raw bytes, GET https://www.kharkovforum.com/api/attachments/ATTACHMENT_ID/data with the XF-Api-Key header. 6. To search, POST https://www.kharkovforum.com/api/search/ with header Content-Type: application/x-www-form-urlencoded and body keywords=WORDS. The parameter name is keywords, not q. The response field search_id is the result list. Then GET https://www.kharkovforum.com/api/search/SEARCH_ID/. Each item has type thread or post. Open that thread with the posts URL above. ## MCP - [MCP server](https://www.kharkovforum.com/mcp): public read-only MCP, no API key. POST JSON-RPC. Call search with keywords, then get_posts with thread_id. Posts can include attachments and direct_url. Open direct_url without a key. Do not open this URL with GET. ## API - [Nodes](https://www.kharkovforum.com/api/nodes/): public section tree. Header XF-Api-Key from above. Fields: node_id, title, node_name, view_url. - [Thread](https://www.kharkovforum.com/api/threads/THREAD_ID/): one thread's title and counters. Replace THREAD_ID. - [Posts](https://www.kharkovforum.com/api/threads/THREAD_ID/posts/): post text. Add ?page=1. Use message. - [Attachment file](https://www.kharkovforum.com/api/attachments/ATTACHMENT_ID/data): raw file. Replace ATTACHMENT_ID from the post's Attachments array. - [Search](https://www.kharkovforum.com/api/search/): POST form field keywords=WORDS. Response includes search_id and result_count. - [Search results](https://www.kharkovforum.com/api/search/SEARCH_ID/): one page of matches. Replace SEARCH_ID. - [Latest posts RSS](https://www.kharkovforum.com/forums/-/index.rss): new threads across the forum, no API key. - [Newest posts page](https://www.kharkovforum.com/whats-new/posts/): newest posts on the website, no API key. ## Forums - [Main](https://www.kharkovforum.com/forums/main/): The main forum of KharkovForum, general discussions and announcements. - [Auto](https://www.kharkovforum.com/forums/auto/): Automotive and hobby discussions, cars, motorcycles, and auto-related topics. - [Black list](https://www.kharkovforum.com/forums/blacklist/): Community-maintained list of problematic companies. - [Software](https://www.kharkovforum.com/forums/software/): Software, programming tools, apps, and technology discussion. - [Kids](https://www.kharkovforum.com/forums/kids/): Discussions about children, parenting, and family life. - [Business & Taxes](https://www.kharkovforum.com/forums/business/): Business, finance, and taxation discussions. - [Alternative Medicine](https://www.kharkovforum.com/forums/alternativemedicine/): Discussions about non-traditional and folk medicine. - [Real Estate](https://www.kharkovforum.com/forums/realestate/): Property, buying/selling, renting, and real estate discussions. - [Ad Archive](https://www.kharkovforum.com/forums/reklama_archive/): Archive of advertising topics from the forum. - [Health](https://www.kharkovforum.com/forums/health/): Health, wellness, and medical discussions. - [Motorbike](https://www.kharkovforum.com/forums/motorbike/): Motorcycle enthusiasts, scooter riders, and biking discussions. - [Sites & Programming](https://www.kharkovforum.com/forums/sites/): Programming, web development, and site creation discussions. - [Works of Our Members](https://www.kharkovforum.com/forums/works_of_our_members/): Showcasing music, art, and projects by forum members. - [Hardware](https://www.kharkovforum.com/forums/hardware/): Computer hardware, electronics, and tech discussions. - [Women](https://www.kharkovforum.com/forums/women/): Female-focused topics and discussions. - [Emigration](https://www.kharkovforum.com/forums/emigration/): Immigration, relocation, and living abroad discussions. - [Mobile World](https://www.kharkovforum.com/forums/mobile_world/): Mobile devices, networks, and technology. - [Search for Musicians](https://www.kharkovforum.com/forums/search_for_musicians/): Connecting musicians and music-related discussions. - [Bicycle](https://www.kharkovforum.com/forums/bicycle/): Cyclists from Kharkov discuss bicycles and cycling topics. - [Internet & LAN](https://www.kharkovforum.com/forums/Internet/): Internet services, networking, and LAN discussions. - [Legal](https://www.kharkovforum.com/forums/legal/): Legal advice, law, and regulatory discussions. - [Men](https://www.kharkovforum.com/forums/men/): Male-focused discussions and topics. - [Aquarium](https://www.kharkovforum.com/forums/aquarium/): Aquarium hobbyists, fish, and aquatic life discussions. - [Animals](https://www.kharkovforum.com/forums/animals/): Pets, wildlife, and animal care discussions. - [News](https://www.kharkovforum.com/forums/news/): Local and global news discussions. - [Games](https://www.kharkovforum.com/forums/games/): Computer games, video games, and gaming discussions. - [Our City](https://www.kharkovforum.com/forums/city/): Discussions about Kharkov city life and events. - [Cinema](https://www.kharkovforum.com/forums/cinema/): Movies, reviews, and film discussions. - [Politics](https://www.kharkovforum.com/forums/politics/): Political discussions and debates. - [TV](https://www.kharkovforum.com/forums/tv/): Television shows and media discussions. - [Student Forum](https://www.kharkovforum.com/forums/students/): Student life, education, and campus discussions. - [Collecting](https://www.kharkovforum.com/forums/collecting/): Collectors and hobbies related to collecting items. - [Literature](https://www.kharkovforum.com/forums/literature/): Books, poetry, and literary discussions. - [Theaters](https://www.kharkovforum.com/forums/theaters/): Upcoming theater events and cultural activities. - [Modelism](https://www.kharkovforum.com/forums/modelism2/): Scale modeling hobby discussions. - [Lost & Found](https://www.kharkovforum.com/forums/lostandfound/): Search for missing people and found items in Kharkov. - [Music](https://www.kharkovforum.com/forums/music/): Music discussions, concerts, and instruments. - [Science & Tech](https://www.kharkovforum.com/forums/science/): Scientific and technical discussions. - [Travel Photos](https://www.kharkovforum.com/forums/travelphotos/): Photo reports from travels and trips. - [Hunting & Fishing](https://www.kharkovforum.com/forums/fishing/): Hunting, fishing, and outdoor activities. - [Kharkiv History](https://www.kharkovforum.com/forums/kharkiv/): History of Kharkov city and region. - [Handyman](https://www.kharkovforum.com/forums/handyman/): DIY, repair, and household discussions. - [Radio & Electronics](https://www.kharkovforum.com/forums/radio_electronics/): Radio, electronics, and technical projects. - [Plants](https://www.kharkovforum.com/forums/plants/): Gardening, plants, and botany discussions. - [Sport](https://www.kharkovforum.com/forums/sport/): Sports and physical activities discussions. - [Cooking](https://www.kharkovforum.com/forums/cooking/): Culinary arts and cooking discussions. - [Creation](https://www.kharkovforum.com/forums/creation/): Creative arts, crafts, and projects. - [Tourism](https://www.kharkovforum.com/forums/tourism/): Travel, tourism, and sightseeing discussions. - [Photo](https://www.kharkovforum.com/forums/photo/): Photography and photo-sharing discussions. - [Philosophy](https://www.kharkovforum.com/forums/philosophy/): Religion, philosophy, and worldviews discussions. - [Forum Games](https://www.kharkovforum.com/forums/lol/): Fun forum games and interactive discussions. ## Classifieds - [Balka](https://www.kharkovforum.com/balka/): Private classifieds and goods for sale listings. ## Optional - [Short index](https://www.kharkovforum.com/llms.txt): the same map, without request examples. - [Agent notes](https://www.kharkovforum.com/AGENTS.md): short rules for agents. - [Help](https://www.kharkovforum.com/help/): FAQ and forum usage instructions. - [Terms & Conditions](https://www.kharkovforum.com/help/terms-and-conditions/): Forum rules and terms of use. - [Privacy Policy](https://www.kharkovforum.com/help/privacy-policy/): Privacy and data protection information. - [Contact](https://www.kharkovforum.com/misc/contact): Contact the forum administration for support or inquiries.