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; may be omitted for a legacy account
displayName	string or null	Display name
username	string or null	Pinterest username
avatarUrl	string or null	Profile image URL
tokenAuthorized	boolean	Whether the Pinterest token is valid
isDomainVerified	boolean	Whether the domain is verified
createdAt	integer or null	When the account was connected (Unix timestamp)

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 account 123456”

---

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; omitted when unnamed
accountId	string	Account ID
boards	array	Board references with id, order, and an optional boardSectionId

Example Usage

“What board lists do I have on account 123456?”

---

tailwind://accounts/[accountId]/timeslots

List all smart schedule timeslots for an account. Each timeslot is a recurring weekly posting time (day of week + time of day + timezone), not a concrete date.

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 of day as a zero-padded 4-digit HHMM string (e.g. “0930”)
time	string	Time of day formatted as 24-hour HH:MM (e.g. “09:30”)
timezone	string	Timezone (e.g., “America/New_York”)
type	string	auto-created, recommended, or manual

Example Usage

“When are my smart schedule timeslots for account 123456?”

---

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-01T00:00:00Z&endDate=2024-01-31T23:59:59Z

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 ISO 8601 date-time (required for sent/uploading)
endDate	Filter posts before this ISO 8601 date-time (required for sent/uploading)

Response Fields

Field	Type	Description
id	string	Post ID
status	string	draft, queued, sent, uploading, pending, failed, missed, or deleted
mediaUrl	string	URL of the media file
mediaType	string	image or video
title	string	Pin title; absent when unset
description	string	Pin description; absent when unset
url	string	Destination URL; absent when unset
boardId	string	Target board ID; absent when unset
altText	string	Alt text; absent when unset
isSimplifiedPin	boolean	Whether the post is a simplified pin
sendAt	integer	Scheduled send time (Unix timestamp); absent for drafts
sentAt	integer	Actual send time (Unix timestamp); absent until published
createdAt	integer	Creation time (Unix timestamp)
pinId	string	Pinterest pin ID; absent until published

The posts-list resource returns an object with a posts array and a cursor. The cursor is absent when there are no more results.

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.

Discovery is split across two methods:

• resources/list returns URIs that can be read as-is — today that is tailwind://accounts.
• resources/templates/list returns the URI templates above as uriTemplate values. Substitute the {accountId} / {postId} placeholders (account IDs come from tailwind://accounts) before calling resources/read. Reading a template verbatim is rejected rather than passed upstream.

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