MCP Tools

MCP Tools Reference

Saltus Framework exposes 18 WordPress-native MCP/Abilities tools.

Tool	Ability	REST request	Description
create_post	saltus/create-post	POST /wp/v2/posts	Create a new post in any registered Custom Post Type
create_term	saltus/create-term	POST /wp/v2/{taxonomy_rest_base}	Create a new term in a taxonomy
delete_post	saltus/delete-post	DELETE /wp/v2/posts/123	Delete (trash or force delete) a post by ID
duplicate_post	saltus/duplicate-post	POST /saltus-framework/v1/duplicate/123	Duplicate a WordPress post
export_post	saltus/export-post	GET /saltus-framework/v1/export/123	Export a WordPress post as WXR
get_health	saltus/get-health	GET /saltus-framework/v1/health	Get Saltus Framework health status
get_meta_fields	saltus/get-meta-fields	GET /saltus-framework/v1/meta/{post_type}	Get meta field definitions for a post type
get_model	saltus/get-model	GET /saltus-framework/v1/models/{slug}	Get details of a specific CPT or taxonomy
get_post	saltus/get-post	GET /wp/v2/posts/123	Get a single post with all fields and meta
get_settings	saltus/get-settings	GET /saltus-framework/v1/settings/{post_type}	Get Saltus settings for a post type
list_meta_fields	saltus/list-meta-fields	GET /saltus-framework/v1/meta	List meta field definitions for all CPTs
list_models	saltus/list-models	GET /saltus-framework/v1/models	List all registered CPTs and taxonomies
list_posts	saltus/list-posts	GET /wp/v2/posts	Query posts with optional filters
list_terms	saltus/list-terms	GET /wp/v2/{taxonomy_rest_base}	List terms from a taxonomy
reorder_posts	saltus/reorder-posts	POST /saltus-framework/v1/reorder	Batch update post menu order
update_meta_fields	saltus/update-meta-fields	PUT /saltus-framework/v1/meta/{post_type}/123	Update meta fields for a post
update_post	saltus/update-post	PUT /wp/v2/posts/123	Update an existing post's fields and meta
update_settings	saltus/update-settings	PUT /saltus-framework/v1/settings/{post_type}	Update Saltus settings for a post type

create_post

Create a new post in any registered Custom Post Type.

• Ability: saltus/create-post
• REST request: POST /wp/v2/posts
• Cacheable: No

Parameter	Type	Required	Default	Description
post_type	string	no	posts	The post type slug
title	string	yes		The post title
content	string	no		The post content
excerpt	string	no		The post excerpt
slug	string	no		URL slug
status	string	no	draft	Post status
meta	object	no		Meta fields as key-value pairs
terms	object	no		Taxonomy terms as {taxonomy: [term_id, ...]}

create_term

Create a new term in a taxonomy.

• Ability: saltus/create-term
• REST request: POST /wp/v2/{taxonomy_rest_base}
• Cacheable: No

Parameter	Type	Required	Default	Description
taxonomy	string	yes		The taxonomy slug
name	string	yes		The term name
slug	string	no		URL slug
description	string	no		Term description
parent	number	no		Parent term ID

delete_post

Delete (trash or force delete) a post by ID.

• Ability: saltus/delete-post
• REST request: DELETE /wp/v2/posts/123
• Cacheable: No

Parameter	Type	Required	Default	Description
post_id	number	yes		The post ID to delete
post_type	string	no	posts	The post type slug
force	boolean	no	false	Whether to force delete (skip trash)

duplicate_post

Duplicate a WordPress post.

• Ability: saltus/duplicate-post
• REST request: POST /saltus-framework/v1/duplicate/123
• Cacheable: No

Parameter	Type	Required	Default	Description
post_id	number	yes		The ID of the post to duplicate

export_post

Export a WordPress post as WXR.

• Ability: saltus/export-post
• REST request: GET /saltus-framework/v1/export/123
• Cacheable: No

Parameter	Type	Required	Default	Description
post_id	number	yes		The ID of the post to export

get_health

Get Saltus Framework health, version, audit error rate, latency, cache, and rate limit status.

• Ability: saltus/get-health
• REST request: GET /saltus-framework/v1/health
• Cacheable: Yes (60s TTL)

This tool does not accept parameters.

get_meta_fields

Get the meta field definitions for a post type.

• Ability: saltus/get-meta-fields
• REST request: GET /saltus-framework/v1/meta/{post_type}
• Cacheable: Yes (600s TTL)

Parameter	Type	Required	Default	Description
post_type	string	yes		The post type slug

get_model

Get details of a specific Custom Post Type or Taxonomy by slug.

• Ability: saltus/get-model
• REST request: GET /saltus-framework/v1/models/{slug}
• Cacheable: Yes (600s TTL)

Parameter	Type	Required	Default	Description
slug	string	yes		The slug of the post type or taxonomy

get_post

Get a single post by ID with all fields and meta data.

• Ability: saltus/get-post
• REST request: GET /wp/v2/posts/123
• Cacheable: Yes (300s TTL)

Parameter	Type	Required	Default	Description
post_id	number	yes		The post ID
post_type	string	no	posts	The post type slug

get_settings

Get the Saltus Framework settings for a specific post type.

• Ability: saltus/get-settings
• REST request: GET /saltus-framework/v1/settings/{post_type}
• Cacheable: Yes (300s TTL)

Parameter	Type	Required	Default	Description
post_type	string	yes		The post type slug

list_meta_fields

List model-defined meta field definitions for all registered Saltus post types.

• Ability: saltus/list-meta-fields
• REST request: GET /saltus-framework/v1/meta
• Cacheable: Yes (600s TTL)

This tool does not accept parameters.

list_models

List all registered Custom Post Types and Taxonomies.

• Ability: saltus/list-models
• REST request: GET /saltus-framework/v1/models
• Cacheable: Yes (600s TTL)

Parameter	Type	Required	Default	Description
type	string	no	all	Filter: post_types, taxonomies, or all

list_posts

Query posts from a Custom Post Type with optional filters.

• Ability: saltus/list-posts
• REST request: GET /wp/v2/posts
• Cacheable: Yes (300s TTL)

Parameter	Type	Required	Default	Description
post_type	string	no	posts	The post type slug
status	string	no	publish	Post status filter
search	string	no		Search term
per_page	number	no	20	Posts per page (max 100)
page	number	no	1	Page number
orderby	string	no	date	Sort field
order	string	no	desc	Sort order
terms	object	no		Taxonomy term filters

list_terms

List terms from a taxonomy.

• Ability: saltus/list-terms
• REST request: GET /wp/v2/{taxonomy_rest_base}
• Cacheable: Yes (300s TTL)

Parameter	Type	Required	Default	Description
taxonomy	string	yes		The taxonomy slug
per_page	number	no	50	Terms per page (max 100)
search	string	no		Search term
hide_empty	boolean	no	false	Hide terms with no posts

reorder_posts

Reorder multiple posts by updating their menu_order values in a single batch operation.

• Ability: saltus/reorder-posts
• REST request: POST /saltus-framework/v1/reorder
• Cacheable: No

Parameter	Type	Required	Default	Description
items	array	yes		Array of {id: post_id, menu_order: int}

update_meta_fields

Update meta fields for a specific post of a registered Saltus post type.

• Ability: saltus/update-meta-fields
• REST request: PUT /saltus-framework/v1/meta/{post_type}/123
• Cacheable: No

Parameter	Type	Required	Default	Description
post_id	number	yes		The post ID to update
post_type	string	yes		The post type slug
meta	object	yes		Meta fields to update as key-value pairs

update_post

Update an existing post's fields and meta data.

• Ability: saltus/update-post
• REST request: PUT /wp/v2/posts/123
• Cacheable: No

Parameter	Type	Required	Default	Description
post_id	number	yes		The post ID to update
post_type	string	no	posts	The post type slug
title	string	no		New post title
content	string	no		New post content
excerpt	string	no		New post excerpt
slug	string	no		New URL slug
status	string	no		New post status
meta	object	no		Meta fields to update

update_settings

Update the Saltus Framework settings for a specific post type.

• Ability: saltus/update-settings
• REST request: PUT /saltus-framework/v1/settings/{post_type}
• Cacheable: No

Parameter	Type	Required	Default	Description
post_type	string	yes		The post type slug
settings	object	yes		The settings data to update