# Tool reference

> Every tool an AI agent can call in your Mark workspace, grouped by job, with read-only and write tools marked.

Source: https://docs.use-mark.com/docs/tool-reference

Mark's MCP server at `https://app.use-mark.com/mcp` has 57 tools. An agent
calls them with your permissions in the workspace you picked when you
connected. To connect one, see
[Connect your AI agent](/docs/use-mark-from-ai-agents).

* **Read-only** tools never change anything.
* **Write** tools change data in your workspace.
* **Write, destructive** tools delete, disconnect, approve, or reject, or
  otherwise can't be taken back. Most clients ask you to confirm them.
* **Costs credit** tools make a paid data lookup and spend workspace
  credit.

## Workspace and brand

| Tool                  | Name                    | What it does                                                                                                        | Access             | Costs credit |
| --------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------ |
| Get Workspace         | `get_workspace`         | Role, timezone, members, sites, a short line per channel, and what needs attention                                  | Read-only          | No           |
| List Channels         | `list_channels`         | Each social channel: whether an account is connected and which one, approval mode, and whether its rules were saved | Read-only          | No           |
| Get Brand Context     | `get_brand_context`     | Voice, visuals, personas, pillars, angles, markets, buyer questions, and KPI targets                                | Read-only          | No           |
| Update Brand Profile  | `update_brand_profile`  | Brand voice or visuals                                                                                              | Write              | No           |
| Save Strategy Item    | `save_strategy_item`    | Create or update a persona, pillar, angle, market, buyer question, or KPI target                                    | Write              | No           |
| Delete Strategy Item  | `delete_strategy_item`  | Permanently delete a persona, pillar, angle, market, or KPI target                                                  | Write, destructive | No           |
| List Market Locations | `list_market_locations` | Look up market locations by place name. Returns codes, country, and languages                                       | Read-only          | No           |
| Set Up Market         | `set_up_market`         | Create or update an active market from a place name and language                                                    | Write              | No           |
| Get Setup Status      | `get_setup_status`      | What is missing (market, site, brand, slots, connections) and which tool or connect link fixes it                   | Read-only          | No           |

## Posts, review, and calendar

| Tool                      | Name                      | What it does                                                                        | Access             | Costs credit |
| ------------------------- | ------------------------- | ----------------------------------------------------------------------------------- | ------------------ | ------------ |
| Get Channel Rules         | `get_channel_rules`       | Length limits, fields, and drafting notes for a channel                             | Read-only          | No           |
| Search Posts              | `search_posts`            | Find posts by status (including the review queue), channel, dates, or text          | Read-only          | No           |
| Get Post                  | `get_post`                | One post's current revision, media, flags, comments, and history                    | Read-only          | No           |
| Get Calendar              | `get_calendar`            | Scheduled and published posts, plus open slots                                      | Read-only          | No           |
| Save Post                 | `save_post`               | Create or edit a draft. Never submits or publishes                                  | Write              | No           |
| Submit Post for Review    | `submit_post`             | Send a draft to review. Auto-approve channels can approve it immediately            | Write              | No           |
| Approve Posts             | `approve_posts`           | Approve exact revisions. They publish at the scheduled time                         | Write, destructive | No           |
| Request Changes or Reject | `review_post`             | Send a post back, or reject it for good                                             | Write, destructive | No           |
| Comment on Post           | `comment_on_post`         | Add a review comment on the current revision                                        | Write              | No           |
| Reschedule Post           | `reschedule_post`         | Move a post to a new future time                                                    | Write              | No           |
| Update Posting Slots      | `update_posting_slots`    | Add or remove recurring weekday and time slots per channel                          | Write              | No           |
| Update Channel Settings   | `update_channel_settings` | Channel settings including approval mode. Auto-approve skips human review           | Write, destructive | No           |
| Resolve External Post     | `resolve_external_post`   | Keep a post published outside Mark, or link it to an existing Mark post. Admin only | Write              | No           |
| Delete Post               | `delete_post`             | Permanently delete a draft that has never been sent for review                      | Write, destructive | No           |
| Archive Post              | `archive_post`            | Stop a post from publishing. It stays in the workspace                              | Write              | No           |

## Assets

| Tool          | Name            | What it does                                                | Access             | Costs credit |
| ------------- | --------------- | ----------------------------------------------------------- | ------------------ | ------------ |
| Search Assets | `search_assets` | Search the media library                                    | Read-only          | No           |
| Get Asset     | `get_asset`     | Preview URL, details, and which posts use it                | Read-only          | No           |
| Add Asset     | `add_asset`     | Import from a public URL, or get a one-time upload URL      | Write              | No           |
| Update Asset  | `update_asset`  | Rename an asset                                             | Write              | No           |
| Delete Assets | `delete_assets` | Permanently delete assets. Can also detach them from drafts | Write, destructive | No           |

## Performance

| Tool                    | Name                      | What it does                                                      | Access    | Costs credit |
| ----------------------- | ------------------------- | ----------------------------------------------------------------- | --------- | ------------ |
| Get Content Performance | `get_content_performance` | Reach, engagement, and clicks by channel, post, pillar, and angle | Read-only | No           |
| Get Search Performance  | `get_search_performance`  | Search Console queries, pages, striking distance, and anomalies   | Read-only | No           |
| Inspect URL             | `inspect_url`             | Ask Google whether a page is indexed, and why. Uses Google quota  | Read-only | No           |

## Keywords and competitors

| Tool                   | Name                     | What it does                                                  | Access             | Costs credit |
| ---------------------- | ------------------------ | ------------------------------------------------------------- | ------------------ | ------------ |
| Research Keywords      | `research_keywords`      | Keyword ideas with volume, difficulty, and intent             | Read-only          | Yes          |
| Check Keyword Audience | `check_keyword_audience` | Who currently ranks for a keyword                             | Read-only          | Yes          |
| List Saved Keywords    | `list_saved_keywords`    | Saved keywords, tags, verdicts, tracking, and latest rank     | Read-only          | No           |
| Save Keywords          | `save_keywords`          | Save keywords and set tags, verdict, and tracking             | Write              | No           |
| Remove Keywords        | `remove_keywords`        | Remove saved keywords and their tracking history              | Write, destructive | No           |
| Analyze Domain         | `analyze_domain`         | Overview, top pages, page keywords, or backlinks for a domain | Read-only          | Yes          |
| Get Rankings           | `get_rankings`           | Tracked positions now and over time                           | Read-only          | No           |
| Run Rank Check         | `run_rank_check`         | Refresh rankings now, outside the schedule                    | Write              | Yes          |

## Websites and site health

| Tool                    | Name                      | What it does                                                      | Access             | Costs credit |
| ----------------------- | ------------------------- | ----------------------------------------------------------------- | ------------------ | ------------ |
| List Sites              | `list_sites`              | Websites, primary site, readiness, and latest audit               | Read-only          | No           |
| Get Site Audit          | `get_site_audit`          | Score, issues by severity, and a prioritized fix plan             | Read-only          | No           |
| Run Site Audit          | `run_site_audit`          | Start a crawl. Poll Get Site Audit for the result                 | Write              | Yes          |
| Check Site Readiness    | `check_site_readiness`    | Re-scan robots.txt, llms.txt, structured data, and speed          | Read-only          | No           |
| Submit URLs to IndexNow | `submit_urls_to_indexnow` | Tell IndexNow search engines about changed URLs. Cannot be undone | Write, destructive | No           |
| Save Site               | `save_site`               | Add or edit a website: hostname, name, primary, and lead capture  | Write              | No           |
| Delete Site             | `delete_site`             | Permanently remove a website and its audits and readiness history | Write, destructive | No           |
| Set Check Cadence       | `set_check_cadence`       | How often a rank check or site audit runs (off or weekly)         | Write              | No           |

## AI visibility

| Tool                        | Name                          | What it does                                                                 | Access    | Costs credit |
| --------------------------- | ----------------------------- | ---------------------------------------------------------------------------- | --------- | ------------ |
| Get AI Visibility           | `get_ai_visibility`           | Buyer questions, AI search volume, assistant referral traffic, and readiness | Read-only | No           |
| Refresh AI Search Volume    | `refresh_ai_volume`           | Re-estimate how often buyer questions are asked in AI assistants             | Write     | Yes          |
| Check AI Assistant Tracking | `check_ai_assistant_tracking` | Check that ChatGPT, Perplexity, and other assistants are tracked on a site   | Read-only | No           |

## Connections

| Tool                       | Name                         | What it does                                                                                            | Access             | Costs credit |
| -------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------ | ------------ |
| List Connections           | `list_connections`           | Integrations, their health, last sync, and failed jobs. Social accounts share one Social publishing row | Read-only          | No           |
| Get Connect Link           | `get_connect_link`           | Link to connect a provider in the Mark app. Connecting happens in the browser                           | Read-only          | No           |
| Sync Connections           | `sync_connections`           | Refresh an integration's health, retry a failed job, or ingest Drive                                    | Write              | No           |
| Update Connection Settings | `update_connection_settings` | Save a Search Console or GA4 property, or Drive folders to watch                                        | Write              | No           |
| Disconnect Account         | `disconnect_connection`      | Disconnect an integration. Social publishing disconnects every social account at once                   | Write, destructive | No           |
| Email Setup Checklist      | `send_setup_checklist`       | Email the signed-in user a checklist of connections still waiting                                       | Write              | No           |
