MCP Tools Reference
Tools are actions that AI assistants can perform on your behalf. The Tailwind MCP Server provides tools for creating, scheduling, and managing Pinterest posts.
create_post
Create a new Pinterest post (pin). If sendAt is provided, the post will be scheduled for that time. Otherwise, it’s saved as a draft.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
accountId | string | Yes | Pinterest account ID |
mediaUrl | string | Yes | URL of the image or video to pin |
mediaType | string | No | Type of media: image (default) or video |
title | string | No | Pin title (max 100 characters) |
description | string | No | Pin description (max 500 characters) |
url | string | No | Destination URL when the pin is clicked |
boardId | string | No | Target Pinterest board ID |
altText | string | No | Alt text for accessibility (max 500 characters) |
sendAt | string | No | When to publish (ISO 8601 format). Omit for draft. |
Example Usage
“Create a pin on my account acc_123 with this image https://example.com/photo.jpg, title it ‘Summer Recipes’, and schedule it for January 20th at 2pm UTC”
Response
The tool returns a confirmation with:
- Post ID
- Status (draft or queued)
- Scheduled time (if applicable)
- Board information
schedule_post
Schedule or reschedule an existing post. Only works for draft or queued posts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
accountId | string | Yes | Pinterest account ID |
postId | string | Yes | Post ID to schedule |
sendAt | string | Yes | When to publish (ISO 8601 format) |
Example Usage
“Schedule post post_abc123 on account acc_123 for tomorrow at 9am”
Response
Returns the updated post with:
- Post ID
- New status (queued)
- Scheduled time
delete_post
Delete a post. Only works for draft or queued posts that haven’t been published yet.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
accountId | string | Yes | Pinterest account ID |
postId | string | Yes | Post ID to delete |
Example Usage
“Delete post post_abc123 from my account acc_123”
Response
Confirms the post was deleted with the post ID.
list_posts
List posts for a Pinterest account with optional filtering by status.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
accountId | string | Yes | Pinterest account ID |
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
“Show me all draft posts on account acc_123”
“List the last 10 sent posts from January 2024”
Response
Returns a list of posts with:
- Post ID
- Status
- Scheduled/sent time
- Title (if set)
- Pagination cursor for next page
Tool Availability
All tools require a valid API key configured in your MCP server settings. Tools are automatically available to the AI assistant once the server is connected.
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 draft and queued posts can be deleted |
| Invalid sendAt | Schedule time is in the past | Use a future date/time |
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