accounts_overviewLABSCO SUMMARY
Answers carry their source and their gaps.
On the SEO side every figure comes back with the source it was measured from and the date it was taken, a revoked Webmaster connection shows up as a source failure rather than as zero traffic, and an audit run with a silent source returns a list of what was not checked instead of quietly scoring it as fine. The advertising side handles the same problem from the other end — it detects the Direct API's silent failures, where a 200 comes back but the edit did not apply. Paid position checks are deliberately kept out of chat because they draw down a Topvisor balance and the price should be on screen first.
What it is
A thin connector to the hosted Direct Manager MCP server. The server, the Direct API access and all the logic run on the service side; this package only attaches your assistant to it. Two separate servers exist on the same account: an advertising one covering Yandex Direct, VK, Avito and Wordstat, and a separate SEO one.
What you get
- Campaign analytics over Direct API v5 and the Reports API, broken down by period, device, gender, age, placement and geography, plus search queries and impression share
- Wasted-spend detection: campaigns with ROAS below 1, spend with no conversions, placements and keywords costing money without returning any
- Management writes: pause and resume, daily and weekly budgets, strategies including conversion strategies with a target CPA or ROAS, negative keywords, keywords, bids and adjustments
- Campaigns built from scratch — campaign, then group, then ad with sitelinks and UTM tags
- AI-derived output: a 30-day spend and conversion forecast, diagnosis of a drop across traffic, conversion rate and CPC, a period-over-period explanation with its drivers, a ranked list of findings in roubles, and a ready weekly brief from a single call
- A cross-account portfolio view on the agency plan — spend, profit, wasted spend and remaining budget per client in one answer —
accounts_overview - A separate SEO server with 21 tools over Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor and Wordstat, of which only three write anything —
seo_overview,seo_search_queries,seo_positions,seo_indexation,seo_audit,seo_page_analysis,seo_opportunities,seo_url_inspection,seo_keyword_demand,seo_competitors,seo_sources, plus the writesseo_add_keywords,seo_add_competitorsandseo_request_recrawl
Requirements
A Direct Manager account with an active plan — without one the server exposes zero tools. Registration includes a 7-day free trial of the Pro plan. Claude and ChatGPT connect directly by URL at https://app.marketscore.ru/api/mcp and sign in over OAuth 2.1; your Yandex token stays on the service and never reaches the assistant or a local config. Local clients such as Cursor, VS Code, Cline and Zed bridge through this package with npx -y marketscore-direct-mcp; it is marketscore-direct-mcp (1.0.2) on npm. The SEO server is a different URL and a different subscription: https://app.marketscore.ru/api/mcp/seo. Write actions are annotated so the MCP client asks for confirmation before running them.
Setup effort
One command — npx -y marketscore-direct-mcp
USE CASES
Finding where the budget is going nowhere
Ask what wasted money over the last fortnight and get campaigns, placements and keywords with spend and no conversions, quantified in currency.
Acting on the answer without opening the console
Pause the placement, add the keywords to negatives and adjust the budget — with the client confirming each write before it runs.
Explaining a drop to someone who will ask why
Get the period-over-period comparison with its drivers separated into traffic, conversion rate and cost per click.
Reporting across every client account at once
Pull the portfolio overview so spend, profit and remaining budget for all accounts arrive in a single response.
Diagnosing a fall in organic search traffic
On the SEO connector, read the overview and indexation state to see which pages left the index and why, with the source and date behind each number.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
The project says 116; its docs name only accounts_overview.
Requires
npx on PATH
INSTALLATION
Connect your client
Server setup
npx
npx -y marketscore-direct-mcpHosted endpoint
https://app.marketscore.ru/api/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Cursor, Cline, Other MCP clients
{
"mcpServers": {
"direct-manager": {
"command": "npx",
"args": [
"-y",
"marketscore-direct-mcp"
]
}
}
}VS Code
{
"servers": {
"direct-manager": {
"command": "npx",
"args": [
"-y",
"marketscore-direct-mcp"
]
}
}
}Any MCP client — Docker
git clone https://github.com/marketscore/marketscore-direct-mcp.git
cd marketscore-direct-mcp
docker build -t marketscore-direct-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-direct-mcp