MCP Resources Reference

Resources provide read-only access to your Tailwind data. AI assistants can query these to understand your accounts, boards, and scheduled content.

Resource URIs

All resources use the tailwind:// protocol prefix.

---

tailwind://accounts

List all Pinterest accounts connected to your Tailwind organization.

URI Pattern

tailwind://accounts

Response Fields

Field	Type	Description
id	string	Account ID (use this for other resources)
userId	string	Pinterest user ID
displayName	string	Display name
username	string	Pinterest username
avatarUrl	string	Profile image URL
tokenAuthorized	boolean	Whether the Pinterest token is valid
isDomainVerified	boolean	Whether the domain is verified
createdAt	string	When the account was connected

Example Usage

“What Pinterest accounts do I have?“

---

tailwind://accounts/[accountId]/boards

List all Pinterest boards for a specific account.

URI Pattern

tailwind://accounts/{accountId}/boards

Response Fields

Field	Type	Description
id	string	Board ID (use this for creating posts)
name	string	Board name
isCollaborator	boolean	Whether you’re a collaborator on this board
isSecret	boolean	Whether the board is secret

Example Usage

“Show me all boards on my account acc_123”

---

tailwind://accounts/[accountId]/board-lists

List all board lists (collections of boards) for a specific account.

URI Pattern

tailwind://accounts/{accountId}/board-lists

Response Fields

Field	Type	Description
id	integer	Board list ID
name	string	Board list name
accountId	string	Account ID
boards	array	Array of board references with ID and order

Example Usage

“What board lists do I have on acc_123?“

---

tailwind://accounts/[accountId]/timeslots

List all smart schedule timeslots for an account.

URI Pattern

tailwind://accounts/{accountId}/timeslots

Response Fields

Field	Type	Description
id	string	Timeslot ID
accountId	string	Account ID
dayPreference	integer	Day of week (0=Sunday through 6=Saturday)
timePreference	string	Time in HH:MM format
timezone	string	Timezone (e.g., “America/New_York”)
type	string	interval or optimal
sendAt	integer	Unix timestamp of next scheduled send

Example Usage

“When are my smart schedule timeslots for acc_123?“

---

tailwind://accounts/[accountId]/posts

List posts for an account with optional filtering.

URI Pattern

tailwind://accounts/{accountId}/posts
tailwind://accounts/{accountId}/posts?status=draft
tailwind://accounts/{accountId}/posts?status=sent&startDate=2024-01-01&endDate=2024-01-31

Query Parameters

Parameter	Description
status	Filter by: draft, queued, sent, or uploading. Default: queued
limit	Number of results (1-100). Default: 50
cursor	Pagination cursor
startDate	Filter posts after this date (required for sent/uploading)
endDate	Filter posts before this date (required for sent/uploading)

Response Fields

Field	Type	Description
id	string	Post ID
status	string	draft, queued, sent, or uploading
mediaUrl	string	URL of the media file
mediaType	string	image or video
title	string	Pin title
description	string	Pin description
url	string	Destination URL
boardId	string	Target board ID
altText	string	Alt text
sendAt	integer	Scheduled send time (Unix timestamp)
sentAt	integer	Actual send time (Unix timestamp)
createdAt	integer	Creation time (Unix timestamp)
pinId	string	Pinterest pin ID (after publishing)

Example Usage

“Show me my draft posts”

“What posts did I send in January?“

---

tailwind://accounts/[accountId]/posts/[postId]

Get a specific post by ID.

URI Pattern

tailwind://accounts/{accountId}/posts/{postId}

Response

Returns all fields for a single post (same fields as the posts list).

Example Usage

“Show me the details of post post_abc123”

---

Resource Discovery

AI assistants can discover available resources through the MCP protocol. When you ask about your Tailwind data, the assistant will automatically query the appropriate resources.

Best Practices

1. Start with accounts - Query accounts first to get valid account IDs
2. Use specific resources - Query boards or timeslots for specific accounts rather than asking for “everything”
3. Filter when possible - Use status and date filters to narrow down post lists
4. Paginate large results - Use the cursor for accounts with many posts