999 Gateway

Activate Promotions

Activate or deactivate promotion services for an advertisement. IMPORTANT: Only use this tool when user EXPLICITLY asks to activate promotions. This action costs money - fees will be deducted from wallet balance. Use this to enable/disable any combination of promotion services in a single call. Only specify services you want to change - omitted services remain unchanged. === SERVICE PARAMETERS === 1. BOOSTER: { "enable": true, "click_price": 100, // MDL bani (min/max from get_

Add To Favorites

Add an advertisement to the user's favorites list. Can also be used to update the note on an existing favorite. Parameters: - ad_id: Advertisement ID to add (required) - note: Optional personal note about this ad Note: Requires authentication (OAuth or API key).

Create Ad

Create or update an advertisement. IMPORTANT: Only use this tool when user EXPLICITLY asks to create an ad. Always create new ads as DRAFT first (as_draft=true) - let user review before publishing. WORKFLOW: 1. Call get_ad_form(subcategory_id) to see available fields and their feature IDs 2. If you have public image URLs, call upload_photo. Otherwise skip images. 3. Call create_ad with as_draft=true 4. Show user the edit_url to review and publish TIP: When user uploads images to ChatGPT/Claud

Generate Search Url

Generate a 999.md filtered search URL that users can click to view results. Use this to give users a direct link to filtered search results instead of listing individual ads. WORKFLOW (MANDATORY): 1. Use get_category_schema to find filter_ids for your category 2. Use get_filter_details to find feature_ids and option_ids - NEVER guess IDs! 3. Call this tool with the discovered IDs to get a clickable URL WARNING: All filter_ids, feature_ids, and option_ids MUST be discovered via get_category_sc

Get Ad

Get detailed information about a single advertisement by ID. TIP: For multiple ads, use get_ads (batch) instead - it's much more efficient! RESPONSE FORMAT: - Default: returns only id and title (minimal response) - Use additional_fields to request more data additional_fields parameter: - Standard fields: "posted", "expire", "owner", "category", "state" - Features: "feature_XX" format (use FEATURE IDs from get_filter_details, NOT filter IDs!) - Special: "price", "images" CRITICAL: filter_id ≠

Get Ad Form

Get the form structure for creating an ad in a specific category. NO AUTHENTICATION REQUIRED. Use this to discover what fields are required and available for creating an ad. The form contains groups of controls, each control representing a field/feature. REQUIRED FIELDS vary by category. The response shows which fields are required. Look for "required: true" in each control. Common required fields across categories: - Phone/Contacts - Offer type (Sell/Buy) - Description (bilingual: ro + ru)

Get Ads

Get detailed information about multiple advertisements by their IDs (batch request). Use this instead of calling get_ad multiple times - much more efficient! RESPONSE FORMAT: - Default: returns only id and title for each ad (minimal response) - Use additional_fields to request more data additional_fields parameter: - Standard fields: "posted", "expire", "owner", "category", "state" - Features: "feature_XX" format (use FEATURE IDs from get_filter_details, NOT filter IDs!) - Special: "price", "

Get Booster Stats

Get booster performance statistics for an advertisement. Use this to analyze how well the booster is performing: === RETURNED METRICS === - total_clicks: Total clicks received - total_impressions: Total times ad was shown - total_spent: Total amount spent (in MDL bani) - daily_spendings: Current day spending - state: RUNNING, STOPPED, OUT_OF_MONEY, LOW_BUDGET - buckets: Daily breakdown of stats - date: Day of the stats - clicks: Clicks that day - impressions: Impressions that day - s

Get Categories

Get categories of the 999.md platform. HOW TO FIND CATEGORIES: 1. First call: get_categories() → returns ALL parent categories (Transport, Real Estate, Electronics...) 2. Find the parent category ID you need (e.g., Transport = 658) 3. Second call: get_categories(category_id=658) → returns subcategories (Cars, Trucks, Motorcycles...) 4. Use the SUBCATEGORY ID for search_ads (e.g., Cars = 659) PLATFORM HIERARCHY: - PARENT CATEGORIES: Transport (658), Real Estate (270), Electronics, etc. - SUBCAT

Get Category Schema

Get available filters for a SUBCATEGORY. Returns lightweight filter list (id, name, type only). IMPORTANT: Pass a SUBCATEGORY ID (like Cars=659), not a parent category ID (like Transport=658). TWO-STEP FILTER DISCOVERY: 1. get_category_schema(659) → lightweight filter list 2. get_filter_details(category_id=659, filter_ids=[1, 7, 2]) → full details for needed filters Returns filter info: - id: Filter ID for use in search_ads and get_filter_details - name: Human-readable name (e.g., "Brand / Mo

Get Feature Options

Get available options for a feature, with support for hierarchical selections. Use this to get ALL options for SELECT fields, especially for dependent/hierarchical fields like: - Brand → Model → Generation - Region → City → District For hierarchical features (has_children=true in get_ad_form): 1. Call WITHOUT parent_option_id to get top-level options (e.g., all brands) 2. Find the option ID you need from the returned list 3. Call WITH parent_option_id to get child options (e.g., models for tha

Get Features Options

Get available options for MULTIPLE features in a single call. Use this instead of calling get_feature_options multiple times. Returns array of features, each with their options. Note: This returns ALL options for each feature (no parent filtering like get_feature_options). Note: Unlike get_feature_options, this does not require category_id - it queries by feature IDs directly.

Get Filter Details

Get detailed information for filters. Returns feature IDs AND option IDs needed for search_ads. YOU MUST CALL THIS TOOL before using search_ads or generate_search_url with filters. This is the ONLY way to get correct option IDs. NEVER guess or assume option IDs. CRITICAL: filter_id ≠ feature_id! - get_category_schema returns FILTER IDs - This tool reveals the FEATURE IDs and OPTION IDs inside each filter - Use FEATURE IDs (not filter IDs) in additional_fields for search_ads/get_ads The filter

Get Promotion Settings

Get available promotion services and pricing for an advertisement. Use this to discover what promotions are available and their current state: === AVAILABLE SERVICES === 1. BOOSTER - Pay-per-click promotion that shows ad higher in search results - click_price: Cost per click (in MDL bani, 100 bani = 1 MDL) - daily_limit: Maximum daily spending - period: Duration in days (1, 3, 7, 14, 30) - States: RUNNING, STOPPED, OUT_OF_MONEY, LOW_BUDGET 2. AUTO-REPUBLISH - Automatically republ

Get Wallet Balance

Get the authenticated user's wallet balance. Use this before creating paid ads to check if the user has sufficient balance. Balance is returned in bani (1 MDL = 100 bani). Note: Requires authentication. Add MCP with Basic Auth credentials.

My Ads

Get the authenticated user's advertisements. Returns ads from user's cabinet with counters by state. Parameters: - state: Filter by state (all, active, hidden, expired, draft, blocked) - category_id: Filter by main category ID - subcategory_id: Filter by subcategory ID - query: Free text search within your ads - filters: Array of filter objects (same format as search_ads) - sort: SORT_ADS_PRICE_ASC, SORT_ADS_PRICE_DESC, SORT_ADS_DATE_DESC, SORT_ADS_RELEVANCE - limit: Max results (default 20, m

My Favorites

Get the authenticated user's favorite advertisements. Returns ads that the user has added to their favorites list. Parameters: - category_id: Filter by main category ID - subcategory_id: Filter by subcategory ID - query: Free text search within favorites - limit: Max results (default 20, max 100) - skip: Offset for pagination - additional_fields: Extra fields to include (e.g., ["price", "year", "images"]) Note: Requires authentication (OAuth or API key).

Publish Ad

Publish a draft or pay-pending advertisement. IMPORTANT: Only use this tool when user EXPLICITLY asks to publish an ad. This action may cost money - payment will be deducted from wallet balance. Use this to: - Publish a draft ad (state: DRAFT) - Complete payment and publish (state: NEED_PAY) The ad must be owned by the authenticated user. Required parameters: - ad_id: The advertisement ID to publish Note: Requires authentication.

Remove From Favorites

Remove one or more advertisements from the user's favorites list. Parameters: - ad_ids: Array of advertisement IDs to remove (required) Note: Requires authentication (OAuth or API key).

Search Ads

Search advertisements with filters. SEARCH APPROACH (MANDATORY): 1. Analyze user request to identify filter criteria (brand, model, price, year, color, features, location, etc.) 2. Call get_category_schema to get filter IDs for the category 3. Call get_filter_details to get feature IDs AND option IDs - NEVER guess or hardcode option IDs! 4. Call search_ads with the discovered IDs 5. If no filter criteria can be identified from user request → fall back to text query WARNING: Option IDs are NOT

Upload Photo

Upload a photo from a public URL for use in an advertisement. NOTE: For images uploaded to ChatGPT/Claude, you CANNOT transfer them directly. Instead, create the ad as draft (as_draft=true) and tell user to add images on 999.md. Only use this tool if you have a publicly accessible image URL. Returns an image_id that should be used in the create_ad features array. Example: upload_photo(url: "https://example.com/car.jpg") → Returns: { image_id: "abc123.jpg", thumbnail_url: "https://..." }