MCP Tools Reference
Tools are actions that AI assistants can perform on your behalf. The Tailwind MCP Server provides tools for finding accounts and creating, scheduling, listing, or deleting Pinterest posts.
list_accounts
Section titled “list_accounts”List all Pinterest accounts connected to your Tailwind organization. Call this first because every other tool requires an accountId returned by this tool.
This tool has no parameters.
Example Usage
Section titled “Example Usage”“List my Pinterest accounts”
Response
Section titled “Response”Returns each account’s ID, username, display name, domain-verification status, and Pinterest-token status.
create_post
Section titled “create_post”Create a new Pinterest post (pin) from an image or video URL. Without sendAt it is saved as a draft; with sendAt it is scheduled to publish, which also requires title, description, url, and boardId. Each call creates a new post — to change or schedule an existing one, use schedule_post instead.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
accountId |
string | Yes | Numeric Tailwind account ID returned by list_accounts |
mediaUrl |
string | Yes | URL of the image or video to pin |
mediaType |
string | No | Type of media: image (default) or video |
title |
string | Conditional | Pin title (max 100 characters). Required when sendAt is provided. |
description |
string | Conditional | Pin description (max 500 characters). Required when sendAt is provided. |
url |
string | Conditional | Destination URL when the pin is clicked. Required when sendAt is provided. |
boardId |
string | Conditional | Target Pinterest board ID — the numeric board ID from the boards resource, not a board name or URL. Required when sendAt is provided. |
altText |
string | No | Alt text for accessibility (max 500 characters) |
isSimplifiedPin |
boolean | No | Whether to create a simplified pin (default: true). Set to false for a standard pin. |
sendAt |
string | No | When to publish (ISO 8601 format). Must be in the future. Omit for draft. Requires title, description, url, and boardId. |
Example Usage
Section titled “Example Usage”“Create a pin on account 123456 with this image https://example.com/photo.jpg, title it ‘Summer Recipes’, and schedule it for January 20th at 2pm UTC”
Response
Section titled “Response”The tool returns a confirmation with:
- Post ID
- Status (draft or queued)
- Scheduled time (if applicable)
- Board information
schedule_post
Section titled “schedule_post”Schedule or reschedule an existing draft or queued post to publish at a specific time. The post must already have title, description, and url set; a draft without a board also needs boardId. Does not work on posts that have already been published.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
accountId |
string | Yes | Numeric Tailwind account ID returned by list_accounts |
postId |
string | Yes | Post ID to schedule |
sendAt |
string | Yes | When to publish (ISO 8601 format). Must be in the future. |
boardId |
string | Conditional | Target Pinterest board ID — the numeric board ID from the boards resource, not a board name or URL. Required when scheduling a draft that doesn’t already have a board. |
Example Usage
Section titled “Example Usage”“Schedule post post_abc123 on account 123456 for tomorrow at 9am”
Response
Section titled “Response”Returns the updated post with:
- Post ID
- New status (queued)
- Scheduled time
delete_post
Section titled “delete_post”Permanently delete a post that has not been published to Pinterest. Published posts cannot be deleted through Tailwind.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
accountId |
string | Yes | Numeric Tailwind account ID returned by list_accounts |
postId |
string | Yes | Post ID to delete |
Example Usage
Section titled “Example Usage”“Delete post post_abc123 from account 123456”
Response
Section titled “Response”Confirms the post was deleted with the post ID.
list_posts
Section titled “list_posts”List posts for a Pinterest account with optional filtering by status.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
accountId |
string | Yes | Numeric Tailwind account ID returned by list_accounts |
status |
string | No | Filter by status: draft, queued, sent, or uploading. Default: queued |
limit |
number | No | Number of posts to return (1-100). Default: 50 |
cursor |
string | No | Pagination cursor from previous response |
startDate |
string | No | Filter posts after this date (ISO 8601). Required for sent/uploading status. |
endDate |
string | No | Filter posts before this date (ISO 8601). Required for sent/uploading status. |
Example Usage
Section titled “Example Usage”“Show me all draft posts on account 123456”
“List the last 10 sent posts from January 2024”
Response
Section titled “Response”Returns a list of posts with:
- Post ID
- Status
- Scheduled/sent time
- Title (if set)
- Pagination cursor for next page
Tool Availability
Section titled “Tool Availability”All tools require an authenticated Tailwind connection, using OAuth or an API key. Tools are automatically available to the AI assistant once the server is connected.
Error Handling
Section titled “Error Handling”When a tool encounters an error, the AI assistant will explain what went wrong. Common errors include:
| Error | Description | Solution |
|---|---|---|
| Account not found | The account ID doesn’t exist | Verify the account ID with tailwind://accounts resource |
| Post not found | The post ID doesn’t exist | Check the post ID is correct |
| Cannot delete sent post | Post has already been published | Only posts not yet published can be deleted |
| Invalid sendAt | Schedule time is in the past | Use a future date/time |
Best Practices
Section titled “Best Practices”- Always verify account IDs first - Use the accounts resource to get valid IDs
- Provide complete information - Include title, description, and URL for best results
- Use clear scheduling language - Say “January 20th at 2pm EST” rather than “next week”
- Review before publishing - Create drafts first if you want to review before scheduling