Documentation
¶
Overview ¶
Package mcpserver exposes the public API operations as MCP tools: one tool per endpoint, with the same names and arguments as the remote server at https://api.postatron.com/mcp.
Index ¶
Constants ¶
View Source
const ( ToolCreatePost = "create_post" ToolListPosts = "list_posts" ToolGetPost = "get_post" ToolDeletePost = "delete_post" ToolListAccounts = "list_accounts" ToolListProfiles = "list_profiles" ToolGetUsage = "get_usage" ToolGetAnalytics = "get_analytics" ToolCreateUpload = "create_upload" ToolGetUpload = "get_upload" )
Tool names, kept identical to the CLI commands (with underscores).
Variables ¶
View Source
var Version = "1.0.0"
Version is reported to MCP clients in serverInfo. Overridden at release time with -ldflags "-X ...mcpserver.Version=v1.2.3".
Functions ¶
Types ¶
type AnalyticsInput ¶ added in v1.1.0
type AnalyticsInput struct {
Range string `json:"range,omitempty" jsonschema:"One of 7d, 30d or 90d. Defaults to 30d."`
Platform string `` /* 129-byte string literal not displayed */
AccountID string `json:"account_id,omitempty" jsonschema:"Only this connected account (an id from list_accounts)."`
Profile string `json:"profile,omitempty" jsonschema:"Only accounts in this profile (a name or id from list_profiles)."`
Source string `json:"source,omitempty" jsonschema:"all (default) or postatron, to count only posts published with Postatron."`
}
AnalyticsInput is the get_analytics tool input.
type CreatePostInput ¶
type CreatePostInput struct {
Content string `` /* 138-byte string literal not displayed */
Platforms []string `` /* 203-byte string literal not displayed */
AccountIDs []string `json:"account_ids,omitempty" jsonschema:"Specific connected account ids from list_accounts. Use this OR platforms."`
Profile string `` /* 157-byte string literal not displayed */
MediaURLs []string `` /* 154-byte string literal not displayed */
MediaIDs []string `json:"media_ids,omitempty" jsonschema:"Upload ids from create_upload, for files on the person's own device."`
ScheduledAt string `` /* 163-byte string literal not displayed */
}
CreatePostInput is the create_post tool input.
type CreateUploadInput ¶ added in v1.1.0
type CreateUploadInput struct {
Purpose string `json:"purpose,omitempty" jsonschema:"Optional note shown on the upload page, e.g. \"photo for your Tuesday post\"."`
}
CreateUploadInput is the create_upload tool input.
type ListPostsInput ¶
type ListPostsInput struct {
Status string `json:"status,omitempty" jsonschema:"Filter by status: scheduled, pending, processing, published, failed or partial."`
Platform string `json:"platform,omitempty" jsonschema:"Only posts that target this platform, e.g. x or linkedin."`
Profile string `json:"profile,omitempty" jsonschema:"Only posts to accounts in this profile (a name or id from list_profiles)."`
From string `json:"from,omitempty" jsonschema:"RFC 3339 start of the date range (scheduled_at for scheduled posts, created_at otherwise)."`
To string `json:"to,omitempty" jsonschema:"RFC 3339 end of the date range."`
Limit int `json:"limit,omitempty" jsonschema:"Page size, 1-100 (default 25)."`
Cursor string `json:"cursor,omitempty" jsonschema:"next_cursor from a previous page."`
}
ListPostsInput is the list_posts tool input.
type PostIDInput ¶
type PostIDInput struct {
ID string `json:"id" jsonschema:"The post id."`
}
PostIDInput is shared by get_post and delete_post.
type UploadIDInput ¶ added in v1.1.0
type UploadIDInput struct {
ID string `json:"upload_id" jsonschema:"The id from create_upload."`
}
UploadIDInput is the get_upload tool input.
Source Files
Click to show internal directories.
Click to hide internal directories.