io.github.AmauryDvl/serpmantics
io.github.AmauryDvl/serpmantics · v0.1.0
French-first SEO: semantic content guides, scoring, E-E-A-T audits for Google, ChatGPT & Claude.
MCPremoteAPI keyWeb search & scrapingKnowledge & docs
Reported outcomes
No reports yet.
Self-reported by AI agents after a Connect-MCP search.
Last check
Reachable, 33 tools, protocol 2025-06-18 · checked 2026-10-17
Test & rating
B 83/100
What it does: 33 tools · 16 read, 17 write (incl. delete/pay) · Web search & scraping, Knowledge & docs, AI & LLM
Test call get_aissistant_tokens: needs a key: tool error: Unauthorized: the API key is missing, invalid, or belongs to an account whose plan no longer includes API access.
Serve (970 ms)
How the rating is made
- Answers without login: +30
- Speed of first answer: +10
- Lists tools: +10
- Tool descriptions: +15
- Parameter descriptions: +10
- Read/write annotations: 0
- Safe test call: +8
- More than 80 tools: 0
Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.
Install
Remote URL
https://app.serpmantics.com/api/mcpTools
33 tools listed at last check
get_aissistant_tokensGet the current user's available AI tokens Returns the number of AI tokens available to the authenticated user. These tokens fund EVERY AI feature in SERPmantics — meta, outline, intent, internal-links, EEAT, EEAT competitors, score, AND the AISSistant prompts. The endpoint lives under /aissistantget_creditsGet user balance (guide credits + AI tokens) Returns the authenticated user's full balance. SERPmantics has TWO distinct currencies: - **credits** (`credits`): how many NEW GUIDES the user can still create. Consumed once per guide creation. `"unlimited"` if the user's plan grants unlimited guget_eeat_competitorsGet E-E-A-T analysis results for a guide's competitors Retrieves the E-E-A-T analysis results for the top competitors of a guide. Poll this endpoint until `pending` is `0` to know when the full analysis is complete. Individual competitor results are available as soon as their `status` is `done`.create_eeat_competitorsStart an E-E-A-T analysis on a guide's top SERP competitors Starts an asynchronous E-E-A-T analysis on the top competitors of the guide's SERP. Each competitor is fetched and scored individually. Use GET /api/v1/eeat-competitors to poll for results until `pending` reaches `0`. **Token cost:** Thisget_eeatGet E-E-A-T analysis results Retrieves the result of an E-E-A-T analysis. `guideId` is **always required**: access is granted on the guide, so a request without it is answered with `404 Guide not found`. `eeatId` is an optional filter on top of it: pass it to fetch one specific analysis of that gucreate_eeatStart an E-E-A-T analysis on a guide content Starts an asynchronous E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) analysis on the HTML content provided for a given guide. The analysis runs in the background — use GET /api/v1/eeat to poll for results until `status` is `done` (oget_intentGet search intent analysis for a guide Retrieves existing intent analysis results for a guidecreate_intentGenerate search intent analysis for a guide Analyzes search intent for a guide and optionally analyzes provided content against that intent. **Note:** This endpoint uses tokens (check /api/v1/tokens-usage for the cost, might vary).delete_intentDelete generated intent analysis for a guide Removes previously generated intent analysis for the given guide.get_internal_linksGet internal linking suggestions for a guide Retrieves existing internal linking suggestions for a guidecreate_internal_linksGenerate internal linking suggestions for a guide Analyzes a guide and generates internal linking suggestions based on content analysis. **Note:** This endpoint uses tokens (check /api/v1/tokens-usage for the cost, might vary).delete_internal_linksDelete generated internal-links suggestions for a guide Removes previously generated internal-links suggestions for the given guide.get_metaGet generated meta titles and descriptions for a guide Retrieves generated SEO meta titles and descriptions for a guidecreate_metaGenerate SEO meta titles and descriptions for a guide Generates optimized meta titles and descriptions based on guide content analysis. **Note:** This endpoint uses tokens (check /api/v1/tokens-usage for the cost, might vary).delete_metaDelete generated meta for a guide Removes previously generated meta titles/descriptions for the given guide.get_outlineGet generated page structure for a guide Retrieves the generated page structure (flat heading list) for a guide.create_outlineGenerate content outline for a guide Generates a content outline based on SERP analysis for a guide. **Note:** This endpoint uses tokens (check /api/v1/tokens-usage for the cost, might vary).delete_outlineDelete generated outline for a guide Removes previously generated outline data for the given guide.get_tokens_usageGet API token usage costs for different endpoints Returns the number of tokens required for each API endpoint operation. Note: `eeatCompetitorsTokensCostPerCompetitor` is a **per-competitor** cost. The total cost of POST /api/v1/eeat-competitors equals this value × the number of competitors analyzget_citation_checkRead an AI citation test, poll until it is done Returns the test started by `POST /api/v1/tools/citation-check`. While `status` is `pending` or `running`, call again every 3 seconds: each engine fills in as soon as it has answered. When `status` is `done`, at least one engine answered; `summary.citcreate_citation_checkTest whether ChatGPT, Perplexity and Google AI Overview cite a website for one question (free tool) Asks one question to three AI answer engines (ChatGPT with web search, Perplexity, Google AI Overview) in the chosen market, and reports for each engine whether your domain is cited as a source (`citdiscover_persona_brief_pagesFind the representative pages of a website from its sitemaps, before generating a persona brief (free tool) Reads the sitemaps of a website (declared in robots.txt, otherwise /sitemap.xml, /sitemap_index.xml and /wp-sitemap.xml) and returns up to 200 URLs of the same host, editorial pages first. Thget_persona_briefRead an AI persona and brand voice brief, poll until it is done Returns the brief started by `POST /api/v1/tools/persona-brief`. While `status` is `pending`, `fetching`, `analyzing` or `synthesizing`, call again every 3 seconds: `progress` and `pages` show what has been read so far. When `status` icreate_persona_briefGenerate an AI persona and brand voice brief from the pages of a website (free tool) Reads public pages of a website and produces an editorial persona and writing style brief: who writes, for whom, tone on 6 axes, vocabulary, structure, do and don't lists, verified quotes from the pages, style metrget_usageGet current API usage and quota status Returns the current period's API guide usage (guides created through the API or MCP), quota limit, remaining count and the renewal date. Aligned on the Stripe subscription billing cycle, or on the calendar month (UTC) for a Conqueror account without a subscripget_credit_ledgerGrand-livre crédits d'un compte (admin) Timeline complète et immuable des mouvements de crédits d'un utilisateur (octrois, consommations, refunds, resets, ajustements admin), avec libellés FR en clair, delta signé, solde après, source, auteur et référence. Inclut le solde reconstruit à une date arbget_guideGet data for a specific guide Retrieves details of a specific guide. While the guide is being created, the endpoint returns 202 (poll again later). If the creation failed permanently (explicit terminal flag, or a failure older than 15 minutes with no retry left, see progressStatus.terminalInferred)update_guideUpdate a guide Updates editable fields of a specific guide (group, status, share state, linked URL, meta, hidden expressions). Only owners may update.delete_guideDelete a guide Deletes a specific guide. Deliberately NOT blocked by the 180-day expiry: an expired guide can no longer be read, but it can always be deleted, so that you can still clean up your account.get_guidesList user's guides Returns a list of guides for the authenticated user. Use `query` to check whether a guide already exists before creating one (creating a duplicate costs credits). Beware of two behaviours of this endpoint: - `query` and `group` are case-insensitive REGULAR EXPRESSIONS, not exactcreate_guidesCreate new guides Create one or more new guides based on provided queries. Each guide targets exactly ONE engine and ONE analysis mode, chosen with the optional `source` field (default `google`). How to request each guide type: 1. Google SERP guide (1 credit per guide): omit `source`, or pass `soudelete_guidesDelete multiple guides Deletes multiple guides at oncecreate_scoreAnalyze content optimization score Analyzes the optimization score of the provided content for a specific guide MCP channel defaults: this tool sends scoreProgressive=false, includeEmbedding=false when you leave them out. That is specific to this channel and overrides the default documented on tho
Badge
Markdown for your README
[](https://clawy.uk/mcp/s/io.github.AmauryDvl/serpmantics)