Connect AI agents to Stack Exchange

List the comments posted on one or more answers. Returns comment_id, post_id, score, owner and creation_date; pass filter=withbody to include the comment text. Use this for comments on answers. Use stackexchange_question_comments_list for comments on questions.

Get the questions that one or more answers belong to. Returns question_id, title, tags, score and link for each parent question. Use this to go from answer IDs to their questions.

Get one or more answers by ID. Returns answer_id, question_id, score, is_accepted and owner; pass filter=withbody to include the body. Use stackexchange_answers_get when you already have answer IDs. Use stackexchange_question_answers_list to read every answer on a question.

List answers posted on a site, newest activity first by default. Returns answer_id, question_id, score, is_accepted and owner. Use stackexchange_answers_list to browse recent or top answers across a site. Use stackexchange_question_answers_list for one question's answers.

List recent recipients of one or more badges. Returns badge_id, name, rank and user for each award. Use this for specific badges. Use stackexchange_badges_recent_recipients_list for every recent award on a site.

Get one or more badges by ID. Returns badge_id, name, badge_type, rank and award_count; pass filter=withbody for descriptions. Use stackexchange_badges_get when you already have badge IDs.

List all badges on a site, optionally filtered to names containing a substring. Returns badge_id, name, badge_type (named or tag_based), rank (gold, silver, bronze) and award_count. Use stackexchange_badges_list to browse or look up badges. Use stackexchange_badges_get when you have badge IDs.

List badges recently awarded on a site. Returns badge_id, name, rank and the user who earned it. Use this for a site-wide award feed. Use stackexchange_badge_recipients_list for specific badges.

List questions in one or more Collectives. Returns question_id, title, tags, score, answer_count and link. Use this to browse a Collective's questions.

List the tags that belong to one or more Collectives. Returns name, count and collectives. Use this to see which tags a Collective covers.

Get one or more Collectives by slug. Returns slug, name, description, tags and external_links. Use this when you already have Collective slugs.

List the Collectives on a site, in alphabetical order. Returns slug, name, description, tags and external_links. Use stackexchange_collectives_list to discover Collectives. Use stackexchange_collectives_get when you have slugs.

Get one or more comments by ID. Returns comment_id, post_id, score, owner and creation_date; pass filter=withbody to include the comment text. Use stackexchange_comments_get when you already have comment IDs. Use stackexchange_post_comments_list to read the comments on a post.

List comments posted on a site. Returns comment_id, post_id, score, owner and creation_date; pass filter=withbody to include the comment text. Use stackexchange_comments_list to browse comments site-wide. Use stackexchange_post_comments_list for one post's comments.

List events on a site from the last few minutes: new questions, answers, comments, edits and users. Returns event_type, event_id, creation_date, link and excerpt. Use this to poll for new activity; events are kept for only 15 minutes and the default window is 5 minutes.

Create a reusable response filter that includes or excludes specific fields. Returns the filter id string to pass as `filter` on other tools, plus included_fields. Use this when the built-in filters (default, withbody, none, total) don't return the fields you need. Filters never expire, so create once and reuse.

Decode one or more filters to see which fields they include. Returns filter, filter_type and included_fields. Use this to check what a filter returns.

List the signed-in user's inbox items across all Stack Exchange sites. Returns item_type, title, link, site, question_id/answer_id/comment_id, is_unread and creation_date. Use stackexchange_inbox_list for all items. Use stackexchange_inbox_unread_list for unread items only. Requires the read_inbox scope.

List the signed-in user's unread inbox items across all Stack Exchange sites. Returns item_type, title, link, site, is_unread and creation_date. Use stackexchange_inbox_unread_list for new items only. Use stackexchange_inbox_list for the full inbox. Requires the read_inbox scope.

Get statistics and metadata for a single site. Returns total_questions, total_unanswered, total_answers, total_users, questions_per_minute, api_revision and more. Use this for site-level counts. Use stackexchange_sites_list to discover sites.

List the answers the signed-in user has posted on a site. Returns answer_id, question_id, score, is_accepted and creation_date. Use this for the signed-in user. Use stackexchange_user_answers_list for other users.

List the signed-in user's accounts on every Stack Exchange site. Returns site_name, site_url, user_id, reputation, question_count and answer_count for each site. Use this to find which sites the user belongs to and their user_id on each.

List the badges the signed-in user has earned on a site. Returns badge_id, name, rank, badge_type and award_count. Use this for the signed-in user. Use stackexchange_user_badges_list for other users.

List the comments the signed-in user has posted on a site. Returns comment_id, post_id, score and creation_date; pass filter=withbody to include the text. Use this for the signed-in user. Use stackexchange_user_comments_list for other users.

List the questions the signed-in user has bookmarked on a site. Returns question_id, title, tags, score and link. Use this to read the user's bookmarks. Use stackexchange_question_bookmark to add one.

Get the signed-in user's profile on a site. Returns user_id, account_id, display_name, reputation, badge_counts and link; items is empty if the user has no account on that site. Use stackexchange_me_get to learn who is connected and their user_id on a site. Use stackexchange_users_get for other users.

List the signed-in user's activity across every Stack Exchange site. Returns activity_type, api_site_parameter, title, link, score and creation_date. Use this for cross-site activity. Use stackexchange_me_questions_list or stackexchange_me_answers_list for one site.

List the privileges the signed-in user has earned on a site. Returns short_description, description and the reputation each privilege needs. Use this before voting, commenting or editing to check the user is allowed to.

List the questions the signed-in user has asked on a site. Returns question_id, title, tags, score, answer_count, is_answered and link. Use this for the signed-in user. Use stackexchange_user_questions_list for other users.

List unanswered questions within the signed-in user's favorite or interesting tags. Returns question_id, title, tags, score and link. Use this to suggest questions the user could answer.

List the signed-in user's complete reputation history on a site, including private events such as votes they cast. Returns reputation_history_type, reputation_change, post_id and creation_date. Use this for the signed-in user's full history. Use stackexchange_user_reputation_history_list for public history of other users. Requires the private_info scope.

List the tags the signed-in user has been active in on a site. Returns name and count for each tag. Use this for the signed-in user's activity by tag. Use stackexchange_me_top_tags_list for their best-scoring tags.

List the tags where the signed-in user has the highest combined question and answer score. Returns tag_name, answer_score, answer_count, question_score and question_count. Use this for the signed-in user. Use stackexchange_user_top_tags_list for other users.

List the signed-in user's notifications across all Stack Exchange sites (badges, reputation events, moderator messages and similar). Returns notification_type, body, site, post_id, is_unread and creation_date. Use stackexchange_notifications_list for all notifications. Use stackexchange_notifications_unread_list for unread ones. Requires the read_inbox scope.

List the signed-in user's unread notifications across all Stack Exchange sites. Returns notification_type, body, site, post_id and creation_date. Use stackexchange_notifications_unread_list for new notifications only. Use stackexchange_notifications_list for all. Requires the read_inbox scope.

List the comments on one or more posts, whether questions or answers. Returns comment_id, post_id, score, owner and creation_date; pass filter=withbody to include the comment text. Use this when the post type is unknown or mixed. Use stackexchange_question_comments_list or stackexchange_answer_comments_list when it is known.

List the edit revisions of one or more posts. Returns revision_guid, revision_number, revision_type, title, tags, comment, user and creation_date. Use this for a post's edit history. Use stackexchange_revisions_get when you already have revision GUIDs.

List the suggested edits on one or more posts. Returns suggested_edit_id, post_id, comment, proposing_user, approval_date and rejection_date. Use this for one post's suggested edits. Use stackexchange_suggested_edits_list to browse site-wide.

Get one or more posts by ID when you don't know whether each is a question or an answer. Returns post_id, post_type (question or answer), score, owner and link; pass filter=withbody to include the body. Use stackexchange_posts_get for mixed or unknown post types. Use stackexchange_questions_get or stackexchange_answers_get when you know the type.

List posts (questions and answers together) on a site. Returns post_id, post_type, score, owner, creation_date and link. Use stackexchange_posts_list to browse both post types at once. Use stackexchange_questions_list or stackexchange_answers_list for one type.

List every privilege on a site and the reputation it needs. Returns short_description, description and reputation. Use this for the site's privilege ladder. Use stackexchange_me_privileges_list for what the signed-in user has.

List the answers posted to one or more questions. Returns answer_id, question_id, score, is_accepted and owner; pass filter=withbody to include each answer's body. Use this to read the answers to a known question. Use stackexchange_answers_get when you already have answer IDs.

List the comments posted on one or more questions (not on their answers). Returns comment_id, post_id, score, owner and creation_date; pass filter=withbody to include the comment text. Use this for comments on questions. Use stackexchange_answer_comments_list for comments on answers, or stackexchange_post_comments_list when the post type is unknown.

List questions that link to one or more questions (including duplicates pointing at them). Returns question_id, title, tags, score and link for each linking question. Use stackexchange_question_linked_list for explicit links. Use stackexchange_question_related_list for similar questions with no link.

List questions the site considers related to one or more questions. Returns question_id, title, tags, score and link for each related question. Use stackexchange_question_related_list for topical neighbours. Use stackexchange_question_linked_list for questions that explicitly link to the given ones.

Get the timeline of events for one or more questions: revisions, answers, comments, votes and accepts. Returns timeline_type, post_id, user, owner and creation_date for each event. Use this to see the history of a question. Use stackexchange_post_revisions_list for the edit history only.

List questions on a site that have an active bounty. Returns question_id, title, tags, bounty_amount, bounty_closes_date and link. Use this to find questions with open bounties.

Get one or more questions by ID. Returns each question's title, tags, score, answer_count, accepted_answer_id, owner and link; pass filter=withbody to include the body. Use stackexchange_questions_get when you already have question IDs. Use stackexchange_questions_list or stackexchange_questions_search_advanced to find them.

List questions on a site, optionally narrowed to questions that carry all of the given tags. Returns question_id, title, tags, score, answer_count, is_answered, owner and link. Use stackexchange_questions_list to browse by activity, votes or date. Use stackexchange_questions_search_advanced for free-text search, and stackexchange_questions_get when you already have question IDs.

List questions that have no answers at all. Returns question_id, title, tags, score and link. Use this for questions with zero answers. Use stackexchange_questions_unanswered_list to also include questions whose answers have no upvotes.

Search a site's questions by words in the title and/or by tags. Returns question_id, title, tags, score, answer_count and link. Use stackexchange_questions_search for a quick title or tag lookup; at least one of intitle or tagged is required. Use stackexchange_questions_search_advanced for full-text search with more filters, or stackexchange_search_excerpts for result snippets.

Search a site's questions with free text plus filters such as tags, accepted, closed, minimum answers or views, owner and URL. Returns question_id, title, tags, score, answer_count, is_answered and link. Use stackexchange_questions_search_advanced as the main full-text search. Use stackexchange_questions_search for a simple title/tag lookup, or stackexchange_search_excerpts when you want highlighted snippets that also match answers.

Find questions similar to a hypothetical question, based on a title and optional tags. Returns question_id, title, tags, score and link, most similar first when sort=relevance. Use this before posting a question to check for duplicates. Use stackexchange_questions_search_advanced for general text search.

List questions the site considers unanswered: no answer with a positive score. Returns question_id, title, tags, score, answer_count and link. Use this to find questions that still need a good answer. Use stackexchange_questions_no_answers_list for questions with zero answers.

Get one or more post revisions by revision GUID. Returns revision_guid, post_id, revision_number, revision_type, title, tags, comment and user. Use stackexchange_revisions_get when you already have revision GUIDs (from stackexchange_post_revisions_list or stackexchange_question_timeline_get).

Search a site with the same filters as stackexchange_questions_search_advanced and return highlighted snippets of matching questions and answers. Returns item_type, question_id, answer_id, title, excerpt (matches wrapped in <span class="highlight">), score and tags. Use stackexchange_search_excerpts when you need to see why a post matched. Use stackexchange_questions_search_advanced when you only need the matching questions.

List every site in the Stack Exchange network (Stack Overflow, Super User, Server Fault, Ask Ubuntu and the rest). Returns each site's name, site_url, api_site_parameter, audience and site_type. Use this to find the api_site_parameter value that every other per-site tool takes as `site`.

Get one or more suggested edits by ID. Returns suggested_edit_id, post_id, comment, proposing_user, approval_date and rejection_date. Use this when you already have suggested edit IDs.

List suggested edits on a site. Returns suggested_edit_id, post_id, post_type, comment, proposing_user, approval_date and rejection_date. Use stackexchange_suggested_edits_list to browse edits site-wide. Use stackexchange_post_suggested_edits_list for one post.

List the frequently asked questions in one or more tags. Returns question_id, title, tags, score and link. Use this to find canonical questions for a tag.

List tags most often used together with one or more tags. Returns name and count for each related tag. Use this to discover neighbouring tags, for example to refine a search.

Get the synonyms that map onto one or more tags. Returns from_tag, to_tag, applied_count and creation_date. Use this for specific tags. Use stackexchange_tag_synonyms_list for all synonyms on a site.

List every tag synonym on a site. Returns from_tag, to_tag, applied_count, creation_date and last_applied_date. Use stackexchange_tag_synonyms_list to browse all synonyms. Use stackexchange_tag_synonyms_get for the synonyms of specific tags.

List the top 20 answerers in a single tag, for the last month or all time. Returns user, post_count and score for each answerer. Use this to find experts in a tag. Use stackexchange_tag_top_askers_list for the most active askers.

List the top 20 askers in a single tag, for the last month or all time. Returns user, post_count and score for each asker. Use this to find the most active askers in a tag. Use stackexchange_tag_top_answerers_list for experts.

Get the wiki excerpt (usage guidance) for one or more tags. Returns tag_name, excerpt and edit dates; pass filter=withbody to include the full wiki body. Use this to learn what a tag is for before tagging a question.

Get tags on a site by exact name. Returns name, count, has_synonyms, is_required and is_moderator_only for each tag that exists. Use stackexchange_tags_info_get for exact tag names. Use stackexchange_tags_list to search by partial name.

List the tags on a site, optionally filtered to names containing a substring. Returns name, count (number of tagged questions), has_synonyms, is_required and is_moderator_only. Use stackexchange_tags_list to browse or look up tags by partial name. Use stackexchange_tags_info_get when you have exact tag names.

List the answers posted by one or more users on a site. Returns answer_id, question_id, score, is_accepted and creation_date. Use this for other users. Use stackexchange_me_answers_list for the signed-in user.

List a user's accounts on every Stack Exchange site, by account ID. Returns site_name, site_url, user_id, reputation, question_count and answer_count for each site. Use this to find a person's user_id on other sites; it takes account_id (from stackexchange_users_get or stackexchange_me_get), not a site user_id.

List the badges earned by one or more users on a site. Returns badge_id, name, rank, badge_type and award_count. Use this for other users. Use stackexchange_me_badges_list for the signed-in user.

List the comments posted by one or more users on a site. Returns comment_id, post_id, score and creation_date; pass filter=withbody to include the text. Use this for other users. Use stackexchange_me_comments_list for the signed-in user.

List the questions bookmarked by one or more users. Returns question_id, title, tags, score and link. Use this for other users. Use stackexchange_me_favorites_list for the signed-in user.

List comments that mention one or more users. Returns comment_id, post_id, owner and creation_date; pass filter=withbody to include the text. Use this to find where users were @-mentioned.

List a user's activity across every Stack Exchange site, by account ID. Returns activity_type, api_site_parameter, title, link, score and creation_date. Use this for cross-site activity; it takes account_id, not a site user_id. Use stackexchange_user_timeline_list for one site.

List all posts (questions and answers) owned by one or more users. Returns post_id, post_type, score, creation_date and link. Use this for both post types at once. Use stackexchange_user_questions_list or stackexchange_user_answers_list for one type.

List the privileges a single user has earned on a site. Returns short_description, description and the reputation each privilege needs. Use this to check whether a user can vote, comment or edit. Use stackexchange_privileges_list for every privilege on the site.

List the questions asked by one or more users on a site. Returns question_id, title, tags, score, answer_count and link. Use this for other users. Use stackexchange_me_questions_list for the signed-in user.

List questions asked by one or more users that have answers but no accepted answer. Returns question_id, title, tags, answer_count and link. Use this to find questions where the asker could still accept an answer.

List questions asked by one or more users that the site considers unanswered. Returns question_id, title, tags, score, answer_count and link. Use this to find a user's questions that still need answers.

List the public reputation history of one or more users. Returns user_id, reputation_history_type, reputation_change, post_id and creation_date. Use this for other users. Use stackexchange_me_reputation_history_full_list for the signed-in user's full, private history.

List recent reputation changes for one or more users, tied to the posts that caused them. Returns user_id, post_id, post_type, vote_type, reputation_change and on_date. Use this to explain reputation changes by post. Use stackexchange_user_reputation_history_list for a plain history.

List the tags one or more users have been active in on a site. Returns name and count for each tag. Use this for activity by tag. Use stackexchange_user_top_tags_list for the user's best-scoring tags.

List the public actions taken by one or more users: posts, comments, badges, edits and accepts. Returns timeline_type, post_id, title, detail and creation_date. Use this for a user's recent activity on one site. Use stackexchange_user_network_activity_list for activity across the network.

List a single user's top answers on questions carrying one or more tags. Returns answer_id, question_id, score and is_accepted. Use this to show a user's best work in a topic.

List the tags where a single user has the highest combined question and answer score. Returns tag_name, answer_score, answer_count, question_score and question_count. Use this to see a user's strongest topics. Use stackexchange_me_top_tags_list for the signed-in user.

List the active moderators on a site who won a moderator election. Returns user_id, display_name, reputation and link. Use this for elected moderators. Use stackexchange_users_moderators_list to include staff and appointed moderators.

Get one or more users on a site by user ID. Returns user_id, account_id, display_name, reputation, badge_counts, creation_date and link. Use stackexchange_users_get when you already have user IDs. Use stackexchange_me_get for the signed-in user.

List users on a site, optionally filtered to display names containing a substring. Returns user_id, account_id, display_name, reputation, badge_counts, location and link. Use stackexchange_users_list to find users by name or rank by reputation. Use stackexchange_users_get when you already have user IDs.

List users with moderator powers on a site. Returns user_id, display_name, reputation, user_type and link. Use stackexchange_users_moderators_list for everyone with moderator powers. Use stackexchange_users_elected_moderators_list for elected moderators only.

Mark an answer as accepted on a question the signed-in user asked. Returns the accepted answer. Use this only on answers to the user's own questions, when no other answer is accepted. Use stackexchange_answer_accept_undo to remove the accept. Requires the write_access scope.

Remove the accept mark the signed-in user placed on an answer. Returns the answer, no longer accepted. Use this to reverse stackexchange_answer_accept. Requires the write_access scope.

Post a new answer to a question as the signed-in user. Returns the created answer, including answer_id. Use this to answer a question. Set preview=true to validate without posting. Requires the write_access scope.

Cast a downvote on a answer as the signed-in user. Returns the answer. Use stackexchange_answer_downvote to vote down. Use stackexchange_answer_downvote_undo to retract it. Requires the write_access scope and the site's vote-down privilege.

Retract the signed-in user's downvote on a answer. Returns the answer. Use this to reverse stackexchange_answer_downvote. Requires the write_access scope.

Edit the body of an existing answer as the signed-in user. Returns the edited answer. Use this to change an answer's body. Requires the write_access scope and permission to edit the post.

Cast an upvote on a answer as the signed-in user. Returns the answer. Use stackexchange_answer_upvote to vote up. Use stackexchange_answer_upvote_undo to retract it. Requires the write_access scope and the site's vote-up privilege.

Retract the signed-in user's upvote on a answer. Returns the answer. Use this to reverse stackexchange_answer_upvote. Requires the write_access scope.

Add a comment to a question or answer as the signed-in user. Returns the created comment, including comment_id. Use this to comment on any post. Set preview=true to validate without posting. Requires the write_access scope and enough reputation to comment.

Edit the text of a comment the signed-in user wrote. Returns the edited comment. Use this to change a comment's text. Requires the write_access scope; comments can usually only be edited for a short time after posting.

Cast an upvote on a comment as the signed-in user. Returns the comment. Use stackexchange_comment_upvote to vote up a comment. Use stackexchange_comment_upvote_undo to retract it. Requires the write_access scope.

Retract the signed-in user's upvote on a comment. Returns the comment. Use this to reverse stackexchange_comment_upvote. Requires the write_access scope.

Bookmark (previously "favorite") a question for the signed-in user. Returns the bookmarked question. Use stackexchange_question_bookmark to save a question. Use stackexchange_question_bookmark_undo to remove it, and stackexchange_me_favorites_list to list bookmarks. Requires the write_access scope.

Remove a question from the signed-in user's bookmarks. Returns the question. Use this to reverse stackexchange_question_bookmark. Requires the write_access scope.

Post a new question on a site as the signed-in user. Returns the created question, including question_id and link. Use stackexchange_questions_similar first to avoid duplicates. Set preview=true to validate without posting. Requires the write_access scope; low-quality checks that would show a CAPTCHA on the site make the call fail.

Cast a downvote on a question as the signed-in user. Returns the question. Use stackexchange_question_downvote to vote down. Use stackexchange_question_downvote_undo to retract it. Requires the write_access scope and the site's vote-down privilege.