List all Topvisor API v2 services, operators, methods, searcher_key reference, filter operators, and all 17 tools in this MCP server. Works without credentials.

Generic escape hatch: call any Topvisor API v2 method directly. Covers all API methods including undocumented ones not yet available as typed tools. Use operator/service/method path and pass body verbatim.

Get account balance. Returns balance calculated from transaction history (sum of all deposits minus charges).

NOTE: The Topvisor bank_2/info endpoint returns empty result for single-user accounts — this is a known API limitation confirmed empirically (result:[], total:1 regardless of parameters; fields parameter causes error 2003). As a workaround, this tool computes the balance by summing bank_2/history transactions. Returns { computed_balance, transaction_count, last_transactions[] }.

Get account transaction history (deposits, charges, bonuses).

List all projects in the account. Use fields, filters, orders for precise queries. show_searchers_and_regions=1 includes configured search engines and regions.

Create a new project in Topvisor. Returns the new project object. ⚠️ Exact response shape not fully documented — raw result is returned.

Add a search engine (searcher) to a project. Must be done before adding regions.

Add a region to a searcher for a project. After adding, call topvisor_list_regions to get the assigned region_index — region_key (add-time catalog key) is NOT the same as region_index (query-time index used in history/checker calls).

List configured searchers and regions for a project. Returns region_key and region_index for each region.

CRITICAL: region_key (used when adding a region) is NOT the same as region_index (used in topvisor_get_history, topvisor_check_price, topvisor_check_positions). Always call this tool after adding regions to get the correct region_index values.

Example mapping for project 29248320 (green-line24.ru):

• Samara: region_key=51 → region_index=83

• Tolyatti: region_key=240 → region_index=112

• Zhigulyovsk: region_key=11132 → region_index=829

NOTE: Uses get/projects_2/projects with show_searchers_and_regions=2 (NOT searchers_regions/export which returns CSV with no region_index).

List keywords for a project. Supports filtering, ordering, pagination.

Import keywords into a project via CSV. Returns {countSended, countDuplicated, countAdded, countChanged}. To assign keywords to a group, set group_name or include group_name column in CSV headers.

Preview the cost of a position check without actually running it. Returns pricesByUsers.={projectsIds, price}. Use this before topvisor_check_positions to estimate cost.

ASYNC: Submit a position check job to the Topvisor queue. Returns projectsIds immediately — actual data collection runs in the background (minutes to hours depending on queue). To monitor progress, poll topvisor_list_projects for status_positions/positions_percent fields. Read results later via topvisor_get_history once collection is complete. To preview cost first use topvisor_check_price.

Get position history for a project and regions. Requires either 'dates' array OR both 'date1' and 'date2'. Returns keywords[] with positionsData.

Get a positions summary comparing two dates for a project and single region. Returns keyword distribution across top positions with optional dynamics, tops, averages, and visibility metrics.

Get chart data showing position distribution over time for a project and single region. Returns dates array and seriesByProjectsId for chart rendering.

Get SERP snapshots for a project and region. Snapshots are collected when do_snapshots=1 is set in topvisor_check_positions. Returns snapshotsData per keyword. Requires either 'dates' array OR both 'date1' and 'date2'.