> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress.com

> Connect WordPress.com to your Atako agents — 10 read and 2 write actions.

Let your agents run your WordPress.com and Jetpack sites — list sites, read posts, comments, categories, tags, media and stats, and write or update posts as drafts or published articles.

## Connection

* **Authentication**: OAuth 2.0 — you authorize Atako via WordPress.com's consent screen; no key to copy.
* **Scopes requested**:
  * `global`

<Note>
  Nothing to paste: click Connect, sign in with your WordPress.com account and approve Atako — it gets access to all your WordPress.com sites and your Jetpack-connected sites. Prerequisite on the Atako side — an administrator registers an application in the WordPress.com Applications Manager ([https://developer.wordpress.com/apps/new/](https://developer.wordpress.com/apps/new/)) with the redirect URL \$\{API\_URL}/integrations/oauth/callback, and puts its Client ID and Client Secret in INTEGRATION\_OAUTH\_WORDPRESS\_CLIENT\_ID / \_CLIENT\_SECRET.

  See [WordPress.com's documentation](https://developer.wordpress.com/docs/api/).
</Note>

## Read actions (10)

| Action            | Description                                                                                                                                                    |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_me`          | Read the connected WordPress.com user (ID, username, display name, primary site). Use it to check the connection.                                              |
| `get_post`        | Read one post in full: title, HTML content, excerpt, status, date, author, categories, tags, featured image and URL.                                           |
| `get_site`        | Read one site: name, description, URL, language, whether it is a Jetpack site, post and subscriber counts.                                                     |
| `get_site_stats`  | Read the site traffic summary: views and visitors today and yesterday, best day, all-time views, visitors and posts.                                           |
| `list_categories` | List the post categories of a site (ID, name, slug, post count).                                                                                               |
| `list_comments`   | List the comments of a site, newest first, with author name, content, status and the post they belong to.                                                      |
| `list_media`      | List the media library of a site (ID, URL, file name, MIME type, title, dimensions). The ID is what featured\_image expects.                                   |
| `list_posts`      | List or search the posts (or pages) of a site, newest first by default, with their ID, title, status, date, URL and excerpt.                                   |
| `list_sites`      | List the sites the connected user belongs to (WordPress.com and Jetpack) with their ID, name and URL. Start here: every other action takes one of these sites. |
| `list_tags`       | List the post tags of a site (ID, name, slug, post count).                                                                                                     |

## Write actions (2)

| Action        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_post` | Create a post or page on a site. Arguments: site (string, domain or ID), title (string), content (string of HTML), excerpt (string), status (one of draft, publish, pending, private, future — defaults to draft here), date (ISO 8601 string), categories and tags (ONE comma-separated string each, e.g. "News,Product"), format (enum), featured\_image (media ID as a string), slug (string), type ("post" or "page"), sticky and publicize (booleans). Returns the created post with its ID and URL.             |
| `update_post` | Update an existing post — only the fields you pass change. Arguments: site (string, domain or ID), post\_id (integer), then any of title (string), content (string of HTML — replaces the whole body), excerpt (string), status (one of draft, publish, pending, private, future), date (ISO 8601 string), categories and tags (ONE comma-separated string each; they replace the current ones), format (enum), featured\_image (media ID as a string, "" to remove), slug (string), sticky and publicize (booleans). |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.