Notra

Stop tracking a GEO competitor. The name is matched case-insensitively.

Stop tracking a GEO prompt

Delete a GEO prompt sequence

Delete a GitHub or Linear integration. Returns any schedules or events that were disabled as a result.

Delete a post by its ID, including content that may be published on a hosted site.

Delete a GEO project and its settings, prompts, sequences, competitors, scans, checks, and reports. This cannot be undone. The organization's last project cannot be deleted.

Delete a content generation schedule by its ID

Delete a reusable writing skill by name

Remove a webhook subscription and cancel its unsent deliveries

Queue async brand identity generation from a website URL. Notra will scrape the site and extract brand info. Use get_brand_identity_generation_status to poll for completion.

Queue an async post generation job. Notra will analyze your GitHub activity and generate content. Use get_post_generation_status to poll for completion.

Get a single brand identity by its ID, including tone, audience, and language settings

Check the status of an async brand identity generation job

Get a single event trigger by its ID

Get a single feedback entry with its full message, agent metadata and context URL

Get the latest agent readiness report for the project's website: score, failed/partial checks with recommendations, any scan still in flight, and the score history. Never starts a scan.

Compare the two latest GEO scans and list gained or lost mentions, positions and citations

Get one competitor's GEO mention history: daily mentions and the prompts that produced them. Use the brand names reported by get_geo_competitor_share.

Get GEO share of voice: the top brands by mentions with their share of all mentions, plus a summary of the remaining brands. Filter with brands, cap with limit, and set includeTrends for daily trends of the returned brands.

Get a single GEO content brief: the post's outline (sections, FAQ, internal links, checklist), writer status and the resulting post ID. Use get_post for the article itself.

Get the AI traffic tracking install snippets (Next.js, Nuxt, Netlify) and the ingest endpoint. The snippets read the token from an environment variable; manage tracking credentials in the Notra dashboard.

Get GEO mention rates broken down by tracked language

Get compact historical checks for one prompt. Use a returned check id with get_geo_prompt_result_detail for the full answer.

Get the full answer, grounding sources and token metadata for one GEO check

Get a GEO scan's status, planned and completed checks, mentions and explicit failures by engine, plus safe failure details when the scan failed

Get aggregate GEO sentiment, engine breakdowns, timeseries and previous-period comparison

Get the stored thematic GEO sentiment analysis without starting a billed analysis run

Get a project's GEO settings: tracked company name, aliases, languages, answer engines and the recurring scan configuration

Get a compact GEO diagnosis across visibility, sentiment, scan changes, competitors, content gaps, shelf sources, readiness and AI traffic, with deterministic next actions

Get every event in one AI traffic journey

Get the most recent individual requests from AI crawlers and referrals. This endpoint has no time window; use limit to bound it.

Get AI traffic totals for a project's website: crawler and AI-referral visit totals, a per-source breakdown and the daily timeseries behind it

Get GEO mention rates per answer engine: checks, mentions and average position for every engine the project tracks

Get daily GEO mention counts per answer engine, one point per day and engine

Get a single post by its ID, including full content in HTML and markdown

Check the status of an async post generation job. Returns job status and event log.

Get a post's publishing schedule and the state of every destination. Returns a null schedule when nothing is scheduled.

Get a single GEO project by its ID

Get a single reusable writing skill by name

Get a webhook delivery's payload and attempt history

Bulk import GEO competitors from structured rows or raw CSV text. Existing competitors are updated in place rather than duplicated.

Bulk import GEO prompts from structured rows or raw CSV text. Prompts that already exist are skipped, not duplicated.

List the brand guideline colors of a brand identity, including light/dark hex values, role, and usage

List all brand identities configured for your organization

List event triggers that generate content automatically from GitHub releases or pushes. repositoryMap labels each targeted GitHub integration ID with its owner/repo.

List feedback your organization received through its feedback URL, MCP servers or SDKs, filtered by triage status, kind or project

List the competitors tracked for a project's GEO share-of-voice reporting

List a project's GEO content briefs and their statuses. A brief is the outline of a GEO post; match a post to its brief by postId.

List GEO content gaps: prompts where competitors are mentioned but this brand is not, plus Search Console queries with no tracked prompt. Each gap links to the brief already written for it, when there is one.

List the answer engine IDs a project can track. Includes model APIs and consumer surfaces such as google/ai-overview (Google AI Overview), google/gemini (the Gemini app) and openai/chatgpt (the ChatGPT app). Use these IDs for engines in update_geo_settings.

List filtered, paginated GEO prompt results without full answer text or sources. Use checkId with get_geo_prompt_result_detail.

List the GEO prompts tracked for a project: custom prompts plus the ones derived automatically from the brand context

List a project's GEO scans, newest first, with pagination, check totals by engine, and safe failure details

List a bounded page of full answers used as sentiment evidence

List a project's GEO prompt sequences (multi-turn conversations played against answer engines)

List cited and manually tracked GEO shelf sources, including placements and opportunity state

List AI traffic journeys: sessions grouped by agent, showing how many pages one agent read, over what span, with sample paths

List the pages AI crawlers and referrals read most, with the previous window's count for comparison

List enabled GitHub and Linear integrations for your organization. Includes organization details. The slack array is always empty; Slack connections are managed in the Notra dashboard and are not exposed by this API.

List post summaries from Notra (title, status, type, short excerpt) with optional filters for sorting, pagination, status, content type, and brand identity. Use get_post for full content.

List the organization's GEO projects. Most GEO tools take a projectId; call this first to find it.

List scheduled content generation jobs, optionally filtered by repository IDs

List reusable writing skills for your organization

List webhook deliveries across all endpoints, newest first. Page with offset while hasMore is true.

List HTTPS endpoints subscribed to Notra events. Signing secrets are not returned.

List accepted and pending Notra workspaces available to the authenticated account. Organization API keys only return their current workspace. Account API keys return every workspace their user belongs to; the user picks the one other tools act on with NOTRA_ORGANIZATION_ID (stdio), or the /mcp/<workspace> URL or X-Notra-Organization-Id header (HTTP).

Research a topic and plan a GEO content brief, saved as a draft. This books AI credits, is billed, and can take a few minutes. Set autoApprove to start the article writer in the same call.

Queue a failed webhook delivery to be sent again, keeping its attempt history. This sends data to the subscribed external endpoint again and may repeat downstream effects

Run a GEO prompt sequence now, synchronously, against every available answer engine. This uses AI credits and the request can take several minutes; the result reports checks, mentions and engines covered.

Schedule an existing post for publishing in Notra and optionally GitHub, X, or LinkedIn. Replaces a schedule that has not started; later post edits are included when publishing runs, within about a minute of scheduledAt.

Queue an agent readiness scan of the project's website. A scan already running against the same URL is reused (alreadyRunning is true). Poll get_geo_agent_readiness for the result. Requires the agent readiness feature for the organization.

Discover likely competitors for a website domain using AI. Results are cached per organization and domain.

Update a brand color's hex values, name, role, or usage. Only the provided fields change.

Update a brand identity's settings including name, tone, audience, language, and more

Replace an event trigger's configuration. The API takes the full definition, so read it with get_event_trigger first and send every field back. When autoPublish is true, future generated content is automatically published to outputConfig.publishDestination.

Set the triage status of a feedback entry: new, triaged, resolved or archived

Edit a GEO content brief, the outline of a GEO post. Omitted fields keep their value; list fields replace the whole list, so send the full outline when changing sections. Only briefs in draft or failed status can be edited, and the draft post's plan is updated with them. Editing drops research notes such as the baseline and recommended angle. To change a finished article, use update_post.

Enable or disable a tracked GEO prompt

Update a GEO prompt sequence's name, steps or enabled state

Replace all GEO settings and restart the recurring scan schedule. Send every field from get_geo_settings; this endpoint does not merge partial updates. Use engine IDs from list_geo_engines and languages listed in the current settings response.

Update a post's title, slug, markdown, or publication status. Changes to title, slug, or markdown also sync a post linked to GitHub: an open pull request gets a new commit, and a repository set to publish directly gets a direct commit when its live branch allows one. Otherwise, including closed or merged pull requests, GitHub is left as is and no new pull request is opened. Publishing can expose content on a hosted site and request a visibility rescan. A sync failure can occur after the post is saved; check the post and linked PR before retrying.

Rename a GEO project or relink its brand identity

Update an existing content generation schedule. When autoPublish is true, future generated content is automatically published to outputConfig.publishDestination.

Update a reusable writing skill by name

Create or update a tracked GEO competitor. Matches on name, case-insensitively; send previousName to rename an existing competitor. Returns the full competitor list.

Show the current Notra workspace and authenticated account. Use this to confirm which workspace this MCP connection operates against.