Content, SEO and social: MCP tool reference
The Valkiria MCP server at https://valkiria.pro/mcp gives a connected assistant 25 tools for social posts, keyword and search data, app store positions, site audits and market research. 19 of them only read. The assistant picks the tool itself; this page lists what exists, under the names it reports in its tool calls.
01
Tools that read (19)
These only return data. They are not counted against the monthly allowance.
- smm_accounts_list: Read stored social account inventory; no access tokens or live refresh.
- smm_posts_list: Read owned stored social posts with their publication or scheduling status.
- smm_posts_performance: Read dated stored cumulative social post snapshots. Do not sum snapshots across dates or claim missing provider metrics were measured zero. Collector completeness/provenance is unverified; no live refresh.
- seo_keywords_list: Read saved active SEO keywords; no generated search-volume estimates.
- seo_gsc_history: Read stored Search Console daily facts; average positions are not live SERP checks.
- aso_apps_list: Read saved active app inventory.
- aso_keywords_list: Read saved tracked app keywords; numeric AI estimates are excluded.
- aso_positions_history: Read saved app position history. Its measurement provenance is unverified; do not present it as current measured App Store rankings.
- smm_publish: Publishing is unavailable through this tool. Open SMM to inspect the post, destinations and explicit publish confirmation.
- generate_report: Generate a comprehensive report (performance, spend, conversions, or ROI)
- market_intelligence_status: Status and bounded brief summary of one analysis run owned by this account.
- market_intelligence_latest: Latest analysis run for the account (or one project) with a bounded brief summary and the dashboard URL.
- seo_keyword_ideas: Keyword ideas with search volume for seed keywords in a market (Keyword Planner and Search Console when connected). Consumes SEO volume-lookup units of the plan. Returns null volumes when no data source is available.
- seo_site_audit_status: Scores and up to 50 issues of a stored site audit owned by this account.
- seo_gsc_summary: Daily position/click/impression totals and top tracked keywords from the Google Search Console snapshot of an owned project. Empty when the project has no Search Console connection.
- website_audit: Fetch one public URL once and report reach/search/tracking checks (title, description, analytics tags, response time). This is a read of a public site, not of account data.
- smm_generate_post_draft: Generate social post text variants with hashtags. Consumes one AI generation. Nothing is saved or published. Text output follows the language of the request (or the account language when none is given).
- smm_best_time: AI-estimated best posting times per platform; expected engagement is an estimate, not measured data. Consumes one AI generation. Text output follows the language of the request (or the account language when none is given).
- smm_hashtag_research: AI-estimated hashtags for a topic with popularity/relevance/competition labels (estimates, not measured). Consumes one AI generation. Text output follows the language of the request (or the account language when none is given).
02
Tools that change or generate (6)
A change requested through these tools follows the safety rules below: it is a proposal unless the write policy you set for the account allows it.
- generate_ad_copy: Generate AI-powered ad copy variants for a product/service
- generate_campaign_idea: Generate a complete AI-powered campaign plan from a product description and goal
- discover_business_location: Search the client's site and the web again for the physical address of one of your cabinets and store the addresses found as candidates waiting for confirmation (each with source URL, evidence and confidence). Does not confirm an address and changes nothing in the ad account; use it when get_business_location shows no candidates or outdated ones
- market_intelligence_start: Enqueue a deep market-intelligence analysis (website audit, market research, competitors). Consumes AI units of the plan. Returns a runId to poll. Report language follows the account language.
- seo_site_audit_start: Crawl up to maxPages public pages of a domain and store a technical SEO audit. Runs synchronously (seconds to a minute). Consumes SEO audit-page units of the plan.
- smm_schedule_post_draft: Save a social post as a draft pending review, optionally with a proposed time and owned destination accounts. Never publishes or schedules for publishing; the owner confirms in the dashboard.
03
How changes stay safe
- Two scopes, chosen by you at sign-in: read, and propose. With read alone the assistant cannot request any change.
- A change requested from an assistant is a proposal. It waits in Approvals in Valkiria until the account owner approves it, unless the write policy you set for that account allows that kind of change by itself.
- New campaigns are created paused. Starting new spend and deleting always wait for a person.
- The assistant can list what is waiting for approval and reject a proposal. It cannot approve one: approval stays with the owner in Valkiria.
- The change history shows who or what made each change and the value before and after, with Undo where the change can be reversed.
- You can disconnect an assistant at any time on the Connect AI page; a developer API key can be deleted the same way.
04
Limits
- The assistant sees only your own Valkiria workspace, and only the ad accounts connected there.
- Numbers are as fresh as the last sync or import; the assistant can tell you when that was.
- Money stays in each account's own currency. Different currencies are not converted or added up.
- Reading data is not counted against the monthly allowance; changes and AI generations are. Allowances per plan are on the pricing page.
05
FAQ
Connect an assistant and call the first tool
Create a free account, connect an ad account and add the connector. The first pass only reads.