{"app":"lotsblog","name":"Lots.Blog","mcp_url":"https://api.lots.blog/mcp","docs_url":"https://api.lots.blog/docs.md","tools":[{"name":"accept_blog_transfer","title":"Accept Blog Transfer","description":"For the person a blog was transferred to. With no arguments: the transfers waiting for you. With transfer_id (or the token from the email link) and no confirm: what moves with the blog and whether your LotsBlog plan or credits cover it; show this to the user before accepting. With confirm: true, under the user's instruction: accept. You become the owner and your plan or credits pay for the blog from today; the previous owner stays on the team if they chose to. Refused with FUNDING_REQUIRED when your plan or credits do not cover one more blog (nothing changes). You must be signed in with the address the transfer was sent to.","category":"team","permission":"write","permission_max":"write"},{"name":"cancel_blog_transfer","title":"Cancel Or Decline Blog Transfer","description":"Stop a pending blog transfer, under the user's instruction. The owner cancels with blog_id; the person it was sent to declines with transfer_id (or the token from the email link), and the owner is told. Nothing moves and the link stops working.","category":"team","permission":"write","permission_max":"write"},{"name":"check_domain","title":"Check Domain","description":"Check the owned blog's custom domain (DNS verification and HTTPS certificate) and, when one is set up, its subdirectory (fetches example.com/blog/__lotsblog/subdirectory-check through the user's rewrite). Returns exact records or setup rules and a plain-language next step. Does not change the user's DNS or site.","category":"content","permission":"read","permission_max":"read"},{"name":"complete_image_upload","title":"Complete Image Upload","description":"Verify the uploaded image size and magic bytes before using it in an article. Call after PUT to the URL returned by create_image_upload. Return a public CDN URL.","category":"content","permission":"write","permission_max":"write"},{"name":"connect_domain","title":"Connect Domain","description":"Connect the blog to the owner's own address. Without path: connect a custom hostname (such as blog.example.com) and return the exact required CNAME and optional TXT DNS records; ask the user to set them, then call check_domain. With path (such as /blog): serve the blog at example.com/blog through one rewrite on the user's own site; returns the proxy target, the private proxy secret and copy-ready rules for Cloudflare Workers, Vercel, Next.js, Netlify and Nginx. The rules never contain the secret: they read it from a Worker secret or environment variable named LOTSBLOG_PROXY_SECRET (Nginx: an include file), and each rule's secret_storage says where the user puts it. Give the secret only to the owner for server-side settings, never in code or a committed file. Ask the user to add one rule, then call check_domain. Owner-only; requires an active plan or credits. Never changes DNS or the user's site automatically and never replaces an existing different domain. remove_subdirectory removes a path setup. Never use a lots.blog or lotsblog.com address: the blog already has one.","category":"content","permission":"write","permission_max":"write"},{"name":"create_blog","title":"Create Blog","description":"Create a hosted blog. A plan covers its included blogs; each extra blog costs that plan's own per-blog rate, and without a plan each blog is $9 a month. Capacity is paid from the owner's credits automatically, charged daily. Use get_funding_status for current rates and balance. If credits are insufficient, return the owner settings link so they can top up or choose a plan. Returns the blog and hosting URL.","category":null,"permission":"write","permission_max":"write"},{"name":"create_blog_post","title":"Create Blog Post","description":"Create an article with Markdown content, metadata, topics and optional matching supplemental JSON-LD such as FAQPage. Defaults to a private draft. Return preview_url to the user; sign-in is required for draft preview. Publish or schedule only under explicit user instructions. Use list_topics to choose topic_ids.","category":"posts","permission":"write","permission_max":"send"},{"name":"create_image_upload","title":"Create Image Upload","description":"Prepare a local image upload without passing base64 through MCP. Return a 15-minute presigned PUT URL, headers and file_key. PUT the local bytes then call complete_image_upload. JPEG, PNG, WebP or GIF, at most 25 MB. Requires the blog owner plan and create permission. Uploaded images are public.","category":"content","permission":"write","permission_max":"write"},{"name":"create_topic","title":"Create Topic","description":"Create an article topic/category in the selected blog. An explicit slug is preserved and must be unique within that blog; omit it to generate from the name. Returns the numeric topic ID for topic_ids in article create/update.","category":"topics","permission":"write","permission_max":"write"},{"name":"delete_blog_post","title":"Delete Blog Post","description":"Move a post to Trash under user instructions. It leaves the public site, sitemap, RSS and search at once, and search engines are told it is gone. Nothing is deleted: restore_blog_post returns it to its previous status, and only the blog owner or an admin can delete it forever from the dashboard Trash. Owners and admins can trash any post; editors and authors only their own. Moving a published post to Trash needs the connection's Delete permission (mcp:delete); drafts, scheduled and archived posts need only Create and edit.","category":"posts","permission":"write","permission_max":"delete"},{"name":"delete_media","title":"Delete Media","description":"Permanently delete an unused image belonging to this blog, only under the user instruction. Images referenced by article content, covers or blog appearance cannot be deleted.","category":"content","permission":"delete","permission_max":"delete"},{"name":"delete_topic","title":"Delete Topic","description":"Delete a topic/category under user instructions. Articles remain intact; their association with this topic is removed. Topics with children must be handled first. Select the numeric topic_id from list_topics.","category":"topics","permission":"delete","permission_max":"delete"},{"name":"get_blog","title":"Get Blog Details","description":"Read the blog, current user role, hosting URL and private Markdown blog_guide. Call list_blogs first to select the blog. Read the guide before writing; it is optional and must not be copied into public articles. description is the home page meta description and intro (\"\" when unset). subdirectory shows a path setup on the owner's site (example.com/blog): host, path, url, status pending or verified, and the last check and error; it is null when there is none. ga_measurement_id is the blog's GA4 Measurement ID, or null. reader_sign_in shows how readers sign in (email_code, google, password; available false while the setting rolls out).","category":null,"permission":"read","permission_max":"read"},{"name":"get_blog_analytics","title":"Get Blog Analytics","description":"Retrieves traffic and engagement analytics for a blog, plus a search block with Google Search Console numbers when the blog is connected: clicks, impressions, CTR, average position, daily numbers, top pages and the top 25 searches, with a data_through date (Google runs 2 to 3 days behind). When Search Console is not connected, search.status is not_connected with the settings link, never zeros. Requires blog_id: call list_blogs first to get the blog UUID.","category":"analytics","permission":"read","permission_max":"read"},{"name":"get_blog_post","title":"Get Blog Post","description":"Read the saved article and metadata by blog_id and post_id. Call list_blog_posts to find post IDs. Use this to verify saved content and publication status before retrying an uncertain write.","category":"posts","permission":"read","permission_max":"read"},{"name":"get_funding_status","title":"Check product funding","description":"Check plan coverage, credit funding and current capacity rates. Plan coverage is used first; capacity beyond it is paid from the owner's credits automatically, charged daily (free credits first, then plan credits, then purchased). If credits run low, give the returned settings_url so the owner can top up or choose a plan.","category":"billing","permission":"read","permission_max":"read"},{"name":"get_post_analytics","title":"Get Post Analytics","description":"Read traffic and engagement analytics for an article, plus a search block with its Google Search Console numbers when the blog is connected: clicks, impressions, CTR, average position by day and the top 25 searches for the post. Select blog_id from list_blogs and post_id from list_blog_posts. When Search Console is not connected, search.status is not_connected with the settings link.","category":"posts","permission":"read","permission_max":"read"},{"name":"get_topic","title":"Get Topic","description":"Retrieves details for a specific blog topic. IMPORTANT: Requires blog_id and topic_id — call list_blogs to get the blog UUID, then list_topics to get the topic_id.","category":"topics","permission":"read","permission_max":"read"},{"name":"invite_blog_member","title":"Invite To Blog Team","description":"Invite someone to the blog's team by email as admin, editor or author, under the user's instruction. Sends the LotsBlog invitation email; the link opens on the blog's own address and expires in 7 days. The invitee accepts by signing in with that same email. Owners can invite admins, editors and authors; admins can invite editors and authors. Owner is never an invite role: a blog has one owner. Fails, and keeps nothing, if the email cannot be sent.","category":"team","permission":"send","permission_max":"send"},{"name":"leave_blog","title":"Leave Blog Team","description":"Leave a blog's team yourself, under the user's instruction. Your posts stay on the blog and you keep a reader account; an owner or admin can invite you back. The owner can't leave their own blog.","category":"team","permission":"write","permission_max":"write"},{"name":"list_blog_members","title":"List Blog Team","description":"List the blog's team (owner, admins, editors, authors) with each person's role, plus open invitations. Also returns your own role, your permissions and the roles you may invite. Owners, admins and editors can see the team; authors cannot. Invitation links are included only for owners and admins.","category":"team","permission":"read","permission_max":"read"},{"name":"list_blog_posts","title":"List Blog Posts","description":"List the blog's posts, newest first, with optional filters by type, status and topic, and pagination. Posts in Trash are left out unless status is trashed.","category":"posts","permission":"read","permission_max":"read"},{"name":"list_blogs","title":"List Blogs","description":"Retrieves all blogs where the authenticated user is an owner or active member. Returns blogs with the user's role in each blog (owner, admin, editor, author, user). This is useful for displaying a blog selector in the UI or for determining which blogs the user can manage. Only active blog memberships are included (status='active' in blog_users table). Blogs are returned with their access URLs (either custom domain or subdomain URL).","category":null,"permission":"read","permission_max":"read"},{"name":"list_media","title":"List Media","description":"List a bounded page of image keys and CDN URLs for this blog. Use next_cursor to continue. Images uploaded through MCP are publicly accessible.","category":"content","permission":"read","permission_max":"read"},{"name":"list_support_requests","title":"List Support Requests","description":"List the support requests the signed-in person has sent to the team that builds this product: number, type, title, status (In progress, Waiting for you, Done), last update, the team's latest reply and a link when one is available. Open requests by default; status all includes finished ones. Pass case_number (for example 1042) to see one request. Use it when the person asks about a problem they reported or whether the team has answered.","category":"support","permission":"read","permission_max":"read"},{"name":"list_topics","title":"List Topics","description":"Lists all topics/categories for a blog. IMPORTANT: Requires blog_id — call list_blogs first to get the blog UUID.","category":"topics","permission":"read","permission_max":"read"},{"name":"publish_post","title":"Publish Post","description":"Publish the saved post now, only when the user instructs publication. Select blog_id from list_blogs and post_id from list_blog_posts. Returns the saved publication status.","category":"posts","permission":"send","permission_max":"send"},{"name":"remove_blog_member","title":"Remove From Blog Team","description":"Remove someone from the blog's team, under the user's instruction. Their posts and comments stay; they keep a reader account on the blog. Owners can remove admins, editors and authors; admins can remove editors and authors. The owner can't be removed; to leave yourself use leave_blog. Get member_id from list_blog_members.","category":"team","permission":"delete","permission_max":"delete"},{"name":"remove_subdirectory","title":"Remove Subdirectory","description":"Stop serving the blog at a path on the owner's own site (example.com/blog), under the owner's explicit instruction. Canonical URLs, the sitemap and RSS return to the verified custom domain or the blog's own {subdomain}.lotsblog.com address, which stop redirecting to the path. Ask the user to remove the rewrite from their site afterwards. Removes only the path setup; custom domains are removed in the dashboard. Owner-only. Requires confirm=true. get_blog shows the current path setup.","category":"domains","permission":"delete","permission_max":"delete"},{"name":"resend_blog_invitation","title":"Resend Blog Invitation","description":"Email an open invitation again and extend it by 7 days. Owners and admins, for roles below their own. Get invitation_id from list_blog_members.","category":"team","permission":"send","permission_max":"send"},{"name":"restore_blog_post","title":"Restore Post","description":"Restore a post from Trash to the status it had before (draft, scheduled, published or archived). A schedule that has already passed comes back as a draft. Restoring a published or scheduled post needs publish or schedule permission and active funding. Use list_blog_posts with status trashed to find posts in Trash.","category":"posts","permission":"write","permission_max":"write"},{"name":"revoke_blog_invitation","title":"Revoke Blog Invitation","description":"Cancel an invitation that has not been accepted, under the user's instruction; its link stops working. Owners and admins. Get invitation_id from list_blog_members.","category":"team","permission":"write","permission_max":"write"},{"name":"schedule_post","title":"Schedule Post","description":"Schedule the saved post under the user instructions. Use an ISO 8601 timestamp with timezone, at least five minutes in the future. Select post_id from list_blog_posts. A scheduled status is not confirmation that the article is already live. A published post cannot be scheduled: take it off the blog with unpublish_post first.","category":"posts","permission":"send","permission_max":"send"},{"name":"submit_sitemap","title":"Submit Sitemap To Google","description":"Submit the blog's sitemap to Google Search Console, under the user's instruction. Works when the blog is connected to Search Console (lots.blog dashboard, Analytics, Search tab) and LotsBlog's Search Console account has Full or Owner access to the property; with Restricted access it explains how to give Full access instead. Owners and admins. Returns the sitemap URL and the property it was submitted to. New posts are also announced through the sitemap and IndexNow automatically; use this after a new address or large changes.","category":"search","permission":"write","permission_max":"write"},{"name":"submit_support_request","title":"Submit Support Request","description":"Send a bug report, feature request, feedback or support question to the team that builds this product. It sends exactly the title and details given. Passwords, API keys, tokens and other people's personal data do not belong in a request. Useful details: what was tried, what happened and what was expected; for a failed tool, tool_name, error_message and request_id. The request is filed under the email the person signed in with, and the team replies to that email. Returns the request number, its status, when to expect a reply and a link when one is available. The same error from the same tool within 24 hours is added to the person's open request instead of opening a new one.","category":"support","permission":"send","permission_max":"send"},{"name":"transfer_blog","title":"Transfer Blog To Another Account","description":"Give the blog to another LotsBlog account, under the owner's instruction. Owner only. We email to_email a link; nothing moves until that person signs in to LotsBlog with that address and accepts, and their own plan or credits must cover the blog. Everything moves with it: posts, drafts, topics, media, team, settings, analytics, the custom domain and a /blog path on the owner's site; the blog stays live at the same address. keep_previous_owner (default true) keeps you on the team as previous_owner_role (admin by default, or editor or author); false makes you a reader. One pending transfer per blog: a new one replaces it. The link works for 7 days. get_blog shows the pending transfer; cancel_blog_transfer cancels it.","category":"team","permission":"delete","permission_max":"delete"},{"name":"unpublish_post","title":"Unpublish Post","description":"Move a published or scheduled article back to a private draft under user instructions. Clears publication time and any pending schedule. The public URL stops serving the article. This is the only way to take a published post off the blog, and it needs the connection's Delete permission (mcp:delete).","category":"content","permission":"delete","permission_max":"delete"},{"name":"update_blog","title":"Update Blog Settings","description":"Update the owned blog name, title, description, privacy or private Markdown blog guide. Only supplied fields change. Use connect_domain/check_domain for custom domains; appearance uses the dashboard; manage the team with list_blog_members, invite_blog_member, update_blog_member_role and remove_blog_member. Also sets the home page description (description; about 155-160 characters, \"\" clears it), robots.txt (robots_txt; \"\" restores the default), the Google Analytics 4 Measurement ID (ga_measurement_id; \"\" removes it) and how readers sign in (email_code_sign_in, google_sign_in, password_sign_in; at least one stays on).","category":null,"permission":"write","permission_max":"write"},{"name":"update_blog_member_role","title":"Change Blog Team Role","description":"Change a team member's role to admin, editor or author, under the user's instruction. Owners can change admins, editors and authors; admins can change editors and authors, and only to roles below admin. Nobody changes their own role or the owner's. Owner is never assignable: ownership moves only through a transfer. Get member_id from list_blog_members.","category":"team","permission":"delete","permission_max":"delete"},{"name":"update_blog_post","title":"Update Blog Post","description":"Update the existing article content, metadata, topics or publication status. Omitted fields are preserved; topic_ids=[] clears topics. Returns preview_url. Use the existing post_id rather than creating a duplicate. Publish or schedule only under user instructions. A published post stays published here: to take it off the blog use unpublish_post, then schedule or archive it if needed.","category":"posts","permission":"write","permission_max":"send"},{"name":"update_topic","title":"Update Topic","description":"Update the topic name, description, slug or metadata. Omitted fields are preserved. Supplied slugs are kept and must be unique within the blog. Select topic_id from list_topics.","category":"topics","permission":"write","permission_max":"write"},{"name":"upload_blog_image","title":"Upload Blog Image","description":"Upload an image from a public/signed image_url or small image_base64. For a local screenshot or larger image, prefer create_image_upload then complete_image_upload. Return the public CDN URL for featured_image in create_blog_post/update_blog_post or article Markdown. Requires the blog owner active plan and content-create permission; image URLs are public even for private blogs.","category":null,"permission":"write","permission_max":"write"}]}