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.

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	auto-created, recommended, or manual
scheduleId	integer	Associated schedule ID, when present
pinUuid	integer	Associated pin UUID, when present
sendAt	integer	Unix timestamp of next scheduled send

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, or uploading
mediaUrl	string	URL of the media file
mediaType	string	image or video
title	string or null	Pin title
description	string or null	Pin description
url	string or null	Destination URL
boardId	string or null	Target board ID
altText	string or null	Alt text
isSimplifiedPin	boolean	Whether the post is a simplified pin
sendAt	integer or null	Scheduled send time (Unix timestamp)
sentAt	integer or null	Actual send time (Unix timestamp)
createdAt	integer	Creation time (Unix timestamp)
pinId	string or null	Pinterest pin ID (after publishing)

The posts-list resource returns an object with a posts array and a cursor. The cursor is null 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.

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