quickcall-integrations 0.4.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -417,6 +417,549 @@ class GitHubClient:
417
417
  html_url=pr.html_url,
418
418
  )
419
419
 
420
+ def create_pr(
421
+ self,
422
+ title: str,
423
+ head: str,
424
+ base: str,
425
+ body: Optional[str] = None,
426
+ draft: bool = False,
427
+ owner: Optional[str] = None,
428
+ repo: Optional[str] = None,
429
+ ) -> PullRequest:
430
+ """
431
+ Create a new pull request.
432
+
433
+ Args:
434
+ title: PR title
435
+ head: Branch containing changes (e.g., "feature-branch")
436
+ base: Branch to merge into (e.g., "main")
437
+ body: PR description
438
+ draft: Create as draft PR
439
+ owner: Repository owner
440
+ repo: Repository name
441
+
442
+ Returns:
443
+ Created PullRequest
444
+ """
445
+ gh_repo = self._get_repo(owner, repo)
446
+ pr = gh_repo.create_pull(
447
+ title=title,
448
+ head=head,
449
+ base=base,
450
+ body=body or "",
451
+ draft=draft,
452
+ )
453
+ return self._convert_pr(pr)
454
+
455
+ def update_pr(
456
+ self,
457
+ pr_number: int,
458
+ title: Optional[str] = None,
459
+ body: Optional[str] = None,
460
+ state: Optional[str] = None,
461
+ base: Optional[str] = None,
462
+ owner: Optional[str] = None,
463
+ repo: Optional[str] = None,
464
+ ) -> PullRequest:
465
+ """
466
+ Update an existing pull request.
467
+
468
+ Args:
469
+ pr_number: PR number
470
+ title: New title
471
+ body: New description
472
+ state: New state ('open' or 'closed')
473
+ base: New base branch
474
+ owner: Repository owner
475
+ repo: Repository name
476
+
477
+ Returns:
478
+ Updated PullRequest
479
+ """
480
+ gh_repo = self._get_repo(owner, repo)
481
+ pr = gh_repo.get_pull(pr_number)
482
+
483
+ kwargs = {}
484
+ if title is not None:
485
+ kwargs["title"] = title
486
+ if body is not None:
487
+ kwargs["body"] = body
488
+ if state is not None:
489
+ kwargs["state"] = state
490
+ if base is not None:
491
+ kwargs["base"] = base
492
+
493
+ if kwargs:
494
+ pr.edit(**kwargs)
495
+
496
+ return self._convert_pr(pr)
497
+
498
+ def merge_pr(
499
+ self,
500
+ pr_number: int,
501
+ commit_title: Optional[str] = None,
502
+ commit_message: Optional[str] = None,
503
+ merge_method: str = "merge",
504
+ owner: Optional[str] = None,
505
+ repo: Optional[str] = None,
506
+ ) -> Dict[str, Any]:
507
+ """
508
+ Merge a pull request.
509
+
510
+ Args:
511
+ pr_number: PR number
512
+ commit_title: Custom commit title (for squash/merge)
513
+ commit_message: Custom commit message
514
+ merge_method: 'merge', 'squash', or 'rebase'
515
+ owner: Repository owner
516
+ repo: Repository name
517
+
518
+ Returns:
519
+ Dict with merge status and SHA
520
+ """
521
+ gh_repo = self._get_repo(owner, repo)
522
+ pr = gh_repo.get_pull(pr_number)
523
+
524
+ # Check if PR is mergeable
525
+ if pr.merged:
526
+ return {
527
+ "merged": True,
528
+ "message": "PR was already merged",
529
+ "sha": pr.merge_commit_sha,
530
+ }
531
+
532
+ if not pr.mergeable:
533
+ return {
534
+ "merged": False,
535
+ "message": "PR is not mergeable (conflicts or checks failing)",
536
+ "sha": None,
537
+ }
538
+
539
+ # Merge the PR
540
+ result = pr.merge(
541
+ commit_title=commit_title,
542
+ commit_message=commit_message,
543
+ merge_method=merge_method,
544
+ )
545
+
546
+ return {
547
+ "merged": result.merged,
548
+ "message": result.message,
549
+ "sha": result.sha,
550
+ }
551
+
552
+ def close_pr(
553
+ self,
554
+ pr_number: int,
555
+ owner: Optional[str] = None,
556
+ repo: Optional[str] = None,
557
+ ) -> PullRequest:
558
+ """Close a pull request without merging."""
559
+ gh_repo = self._get_repo(owner, repo)
560
+ pr = gh_repo.get_pull(pr_number)
561
+ pr.edit(state="closed")
562
+ return self._convert_pr(pr)
563
+
564
+ def reopen_pr(
565
+ self,
566
+ pr_number: int,
567
+ owner: Optional[str] = None,
568
+ repo: Optional[str] = None,
569
+ ) -> PullRequest:
570
+ """Reopen a closed pull request."""
571
+ gh_repo = self._get_repo(owner, repo)
572
+ pr = gh_repo.get_pull(pr_number)
573
+ pr.edit(state="open")
574
+ return self._convert_pr(pr)
575
+
576
+ def add_pr_comment(
577
+ self,
578
+ pr_number: int,
579
+ body: str,
580
+ owner: Optional[str] = None,
581
+ repo: Optional[str] = None,
582
+ ) -> Dict[str, Any]:
583
+ """
584
+ Add a comment to a pull request.
585
+
586
+ Args:
587
+ pr_number: PR number
588
+ body: Comment text
589
+ owner: Repository owner
590
+ repo: Repository name
591
+
592
+ Returns:
593
+ Comment details
594
+ """
595
+ gh_repo = self._get_repo(owner, repo)
596
+ # PRs use the issue comment API
597
+ issue = gh_repo.get_issue(pr_number)
598
+ comment = issue.create_comment(body)
599
+ return {
600
+ "id": comment.id,
601
+ "body": comment.body,
602
+ "html_url": comment.html_url,
603
+ "created_at": comment.created_at.isoformat(),
604
+ "pr_number": pr_number,
605
+ }
606
+
607
+ def request_reviewers(
608
+ self,
609
+ pr_number: int,
610
+ reviewers: Optional[List[str]] = None,
611
+ team_reviewers: Optional[List[str]] = None,
612
+ owner: Optional[str] = None,
613
+ repo: Optional[str] = None,
614
+ ) -> Dict[str, Any]:
615
+ """
616
+ Request reviewers for a pull request.
617
+
618
+ Args:
619
+ pr_number: PR number
620
+ reviewers: List of GitHub usernames
621
+ team_reviewers: List of team slugs (org teams)
622
+ owner: Repository owner
623
+ repo: Repository name
624
+
625
+ Returns:
626
+ Dict with requested reviewers
627
+ """
628
+ gh_repo = self._get_repo(owner, repo)
629
+ pr = gh_repo.get_pull(pr_number)
630
+
631
+ # Create review request
632
+ pr.create_review_request(
633
+ reviewers=reviewers or [],
634
+ team_reviewers=team_reviewers or [],
635
+ )
636
+
637
+ # Re-fetch to get updated reviewers
638
+ pr = gh_repo.get_pull(pr_number)
639
+ return {
640
+ "pr_number": pr_number,
641
+ "requested_reviewers": [r.login for r in pr.requested_reviewers],
642
+ "requested_teams": [t.slug for t in pr.requested_teams],
643
+ }
644
+
645
+ def submit_pr_review(
646
+ self,
647
+ pr_number: int,
648
+ event: str,
649
+ body: Optional[str] = None,
650
+ owner: Optional[str] = None,
651
+ repo: Optional[str] = None,
652
+ ) -> Dict[str, Any]:
653
+ """
654
+ Submit a review on a pull request.
655
+
656
+ Args:
657
+ pr_number: PR number
658
+ event: Review event - 'APPROVE', 'REQUEST_CHANGES', or 'COMMENT'
659
+ body: Review comment (required for REQUEST_CHANGES)
660
+ owner: Repository owner
661
+ repo: Repository name
662
+
663
+ Returns:
664
+ Review details
665
+ """
666
+ gh_repo = self._get_repo(owner, repo)
667
+ pr = gh_repo.get_pull(pr_number)
668
+
669
+ review = pr.create_review(
670
+ body=body or "",
671
+ event=event,
672
+ )
673
+
674
+ return {
675
+ "id": review.id,
676
+ "state": review.state,
677
+ "body": review.body,
678
+ "html_url": review.html_url,
679
+ "pr_number": pr_number,
680
+ }
681
+
682
+ def convert_pr_to_draft(
683
+ self,
684
+ pr_number: int,
685
+ owner: Optional[str] = None,
686
+ repo: Optional[str] = None,
687
+ ) -> Dict[str, Any]:
688
+ """
689
+ Convert a PR to draft status using GraphQL API.
690
+
691
+ Args:
692
+ pr_number: PR number
693
+ owner: Repository owner
694
+ repo: Repository name
695
+
696
+ Returns:
697
+ Dict with success status
698
+ """
699
+ owner = owner or self.default_owner
700
+ repo = repo or self.default_repo
701
+
702
+ if not owner or not repo:
703
+ raise ValueError("Repository owner and name must be specified")
704
+
705
+ # Get PR node ID
706
+ query = """
707
+ query($owner: String!, $repo: String!, $number: Int!) {
708
+ repository(owner: $owner, name: $repo) {
709
+ pullRequest(number: $number) {
710
+ id
711
+ isDraft
712
+ }
713
+ }
714
+ }
715
+ """
716
+ data = self._graphql_request(
717
+ query, {"owner": owner, "repo": repo, "number": pr_number}
718
+ )
719
+ repository = data.get("repository")
720
+ if not repository:
721
+ raise GithubException(
722
+ 404, {"message": f"Repository {owner}/{repo} not found"}
723
+ )
724
+ pr_data = repository.get("pullRequest")
725
+ if not pr_data:
726
+ raise GithubException(404, {"message": f"PR #{pr_number} not found"})
727
+
728
+ if pr_data.get("isDraft"):
729
+ return {
730
+ "pr_number": pr_number,
731
+ "is_draft": True,
732
+ "message": "PR is already a draft",
733
+ }
734
+
735
+ pr_node_id = pr_data["id"]
736
+
737
+ # Convert to draft
738
+ mutation = """
739
+ mutation($pullRequestId: ID!) {
740
+ convertPullRequestToDraft(input: {pullRequestId: $pullRequestId}) {
741
+ pullRequest {
742
+ id
743
+ isDraft
744
+ }
745
+ }
746
+ }
747
+ """
748
+ result = self._graphql_request(mutation, {"pullRequestId": pr_node_id})
749
+ converted = result.get("convertPullRequestToDraft", {}).get("pullRequest", {})
750
+
751
+ return {
752
+ "pr_number": pr_number,
753
+ "is_draft": converted.get("isDraft", True),
754
+ "message": "PR converted to draft",
755
+ }
756
+
757
+ def mark_pr_ready_for_review(
758
+ self,
759
+ pr_number: int,
760
+ owner: Optional[str] = None,
761
+ repo: Optional[str] = None,
762
+ ) -> Dict[str, Any]:
763
+ """
764
+ Mark a draft PR as ready for review using GraphQL API.
765
+
766
+ Args:
767
+ pr_number: PR number
768
+ owner: Repository owner
769
+ repo: Repository name
770
+
771
+ Returns:
772
+ Dict with success status
773
+ """
774
+ owner = owner or self.default_owner
775
+ repo = repo or self.default_repo
776
+
777
+ if not owner or not repo:
778
+ raise ValueError("Repository owner and name must be specified")
779
+
780
+ # Get PR node ID
781
+ query = """
782
+ query($owner: String!, $repo: String!, $number: Int!) {
783
+ repository(owner: $owner, name: $repo) {
784
+ pullRequest(number: $number) {
785
+ id
786
+ isDraft
787
+ }
788
+ }
789
+ }
790
+ """
791
+ data = self._graphql_request(
792
+ query, {"owner": owner, "repo": repo, "number": pr_number}
793
+ )
794
+ repository = data.get("repository")
795
+ if not repository:
796
+ raise GithubException(
797
+ 404, {"message": f"Repository {owner}/{repo} not found"}
798
+ )
799
+ pr_data = repository.get("pullRequest")
800
+ if not pr_data:
801
+ raise GithubException(404, {"message": f"PR #{pr_number} not found"})
802
+
803
+ if not pr_data.get("isDraft"):
804
+ return {
805
+ "pr_number": pr_number,
806
+ "is_draft": False,
807
+ "message": "PR is already ready for review",
808
+ }
809
+
810
+ pr_node_id = pr_data["id"]
811
+
812
+ # Mark ready for review
813
+ mutation = """
814
+ mutation($pullRequestId: ID!) {
815
+ markPullRequestReadyForReview(input: {pullRequestId: $pullRequestId}) {
816
+ pullRequest {
817
+ id
818
+ isDraft
819
+ }
820
+ }
821
+ }
822
+ """
823
+ result = self._graphql_request(mutation, {"pullRequestId": pr_node_id})
824
+ converted = result.get("markPullRequestReadyForReview", {}).get(
825
+ "pullRequest", {}
826
+ )
827
+
828
+ return {
829
+ "pr_number": pr_number,
830
+ "is_draft": converted.get("isDraft", False),
831
+ "message": "PR marked ready for review",
832
+ }
833
+
834
+ def add_pr_labels(
835
+ self,
836
+ pr_number: int,
837
+ labels: List[str],
838
+ owner: Optional[str] = None,
839
+ repo: Optional[str] = None,
840
+ ) -> Dict[str, Any]:
841
+ """
842
+ Add labels to a pull request.
843
+
844
+ Args:
845
+ pr_number: PR number
846
+ labels: List of label names
847
+ owner: Repository owner
848
+ repo: Repository name
849
+
850
+ Returns:
851
+ Dict with updated labels
852
+ """
853
+ gh_repo = self._get_repo(owner, repo)
854
+ # PRs use the issue API for labels
855
+ issue = gh_repo.get_issue(pr_number)
856
+ issue.add_to_labels(*labels)
857
+
858
+ return {
859
+ "pr_number": pr_number,
860
+ "labels": [label.name for label in issue.labels],
861
+ }
862
+
863
+ def remove_pr_labels(
864
+ self,
865
+ pr_number: int,
866
+ labels: List[str],
867
+ owner: Optional[str] = None,
868
+ repo: Optional[str] = None,
869
+ ) -> Dict[str, Any]:
870
+ """
871
+ Remove labels from a pull request.
872
+
873
+ Args:
874
+ pr_number: PR number
875
+ labels: List of label names to remove
876
+ owner: Repository owner
877
+ repo: Repository name
878
+
879
+ Returns:
880
+ Dict with updated labels
881
+ """
882
+ gh_repo = self._get_repo(owner, repo)
883
+ issue = gh_repo.get_issue(pr_number)
884
+
885
+ for label in labels:
886
+ try:
887
+ issue.remove_from_labels(label)
888
+ except GithubException as e:
889
+ if e.status != 404: # Ignore if label not present
890
+ raise
891
+
892
+ # Re-fetch to get updated labels
893
+ issue = gh_repo.get_issue(pr_number)
894
+ return {
895
+ "pr_number": pr_number,
896
+ "labels": [label.name for label in issue.labels],
897
+ }
898
+
899
+ def add_pr_assignees(
900
+ self,
901
+ pr_number: int,
902
+ assignees: List[str],
903
+ owner: Optional[str] = None,
904
+ repo: Optional[str] = None,
905
+ ) -> Dict[str, Any]:
906
+ """
907
+ Add assignees to a pull request.
908
+
909
+ Args:
910
+ pr_number: PR number
911
+ assignees: List of GitHub usernames
912
+ owner: Repository owner
913
+ repo: Repository name
914
+
915
+ Returns:
916
+ Dict with updated assignees
917
+ """
918
+ gh_repo = self._get_repo(owner, repo)
919
+ issue = gh_repo.get_issue(pr_number)
920
+ issue.add_to_assignees(*assignees)
921
+
922
+ return {
923
+ "pr_number": pr_number,
924
+ "assignees": [a.login for a in issue.assignees],
925
+ }
926
+
927
+ def remove_pr_assignees(
928
+ self,
929
+ pr_number: int,
930
+ assignees: List[str],
931
+ owner: Optional[str] = None,
932
+ repo: Optional[str] = None,
933
+ ) -> Dict[str, Any]:
934
+ """
935
+ Remove assignees from a pull request.
936
+
937
+ Args:
938
+ pr_number: PR number
939
+ assignees: List of GitHub usernames to remove
940
+ owner: Repository owner
941
+ repo: Repository name
942
+
943
+ Returns:
944
+ Dict with updated assignees
945
+ """
946
+ gh_repo = self._get_repo(owner, repo)
947
+ issue = gh_repo.get_issue(pr_number)
948
+
949
+ for assignee in assignees:
950
+ try:
951
+ issue.remove_from_assignees(assignee)
952
+ except GithubException as e:
953
+ if e.status != 404: # Ignore if not assigned
954
+ raise
955
+
956
+ # Re-fetch to get updated assignees
957
+ issue = gh_repo.get_issue(pr_number)
958
+ return {
959
+ "pr_number": pr_number,
960
+ "assignees": [a.login for a in issue.assignees],
961
+ }
962
+
420
963
  # ========================================================================
421
964
  # Commit Operations
422
965
  # ========================================================================
@@ -850,6 +850,404 @@ def create_github_tools(mcp: FastMCP) -> None:
850
850
  except Exception as e:
851
851
  raise ToolError(f"Failed to {action} issue(s): {str(e)}")
852
852
 
853
+ @mcp.tool(tags={"github", "prs"})
854
+ def manage_prs(
855
+ action: str = Field(
856
+ ...,
857
+ description="Action: 'list', 'view', 'create', 'update', 'merge', 'close', 'reopen', "
858
+ "'comment', 'request_reviewers', 'review', 'to_draft', 'ready_for_review', "
859
+ "'add_labels', 'remove_labels', 'add_assignees', 'remove_assignees'",
860
+ ),
861
+ pr_numbers: Optional[List[int]] = Field(
862
+ default=None,
863
+ description="PR number(s). Required for view/update/merge/close/reopen/comment/review/labels/assignees actions.",
864
+ ),
865
+ title: Optional[str] = Field(
866
+ default=None,
867
+ description="PR title (for 'create' or 'update')",
868
+ ),
869
+ body: Optional[str] = Field(
870
+ default=None,
871
+ description="PR body/description (for 'create'/'update') or comment text (for 'comment')",
872
+ ),
873
+ head: Optional[str] = Field(
874
+ default=None,
875
+ description="Source branch containing changes (for 'create')",
876
+ ),
877
+ base: Optional[str] = Field(
878
+ default=None,
879
+ description="Target branch to merge into (for 'create', default: repo default branch)",
880
+ ),
881
+ draft: Optional[bool] = Field(
882
+ default=None,
883
+ description="Create as draft PR (for 'create')",
884
+ ),
885
+ merge_method: Optional[str] = Field(
886
+ default="merge",
887
+ description="Merge strategy: 'merge', 'squash', or 'rebase' (for 'merge' action)",
888
+ ),
889
+ reviewers: Optional[List[str]] = Field(
890
+ default=None,
891
+ description="GitHub usernames to request review from (for 'request_reviewers')",
892
+ ),
893
+ team_reviewers: Optional[List[str]] = Field(
894
+ default=None,
895
+ description="Team slugs to request review from (for 'request_reviewers')",
896
+ ),
897
+ review_event: Optional[str] = Field(
898
+ default=None,
899
+ description="Review event: 'APPROVE', 'REQUEST_CHANGES', or 'COMMENT' (for 'review' action)",
900
+ ),
901
+ labels: Optional[List[str]] = Field(
902
+ default=None,
903
+ description="Labels (for 'add_labels' or 'remove_labels')",
904
+ ),
905
+ assignees: Optional[List[str]] = Field(
906
+ default=None,
907
+ description="GitHub usernames for assignees. For 'create': defaults to self if not specified. "
908
+ "For 'add_assignees'/'remove_assignees': required.",
909
+ ),
910
+ owner: Optional[str] = Field(
911
+ default=None,
912
+ description="Repository owner",
913
+ ),
914
+ repo: Optional[str] = Field(
915
+ default=None,
916
+ description="Repository name. Required.",
917
+ ),
918
+ state: Optional[str] = Field(
919
+ default="open",
920
+ description="PR state filter for 'list': 'open', 'closed', or 'all' (default: 'open')",
921
+ ),
922
+ limit: Optional[int] = Field(
923
+ default=20,
924
+ description="Maximum PRs to return for 'list' action (default: 20)",
925
+ ),
926
+ ) -> dict:
927
+ """
928
+ Manage GitHub pull requests: list, view, create, update, merge, close, reopen, comment, and review.
929
+
930
+ Supports bulk operations for view/close/reopen/comment via pr_numbers list.
931
+
932
+ Examples:
933
+ - list: manage_prs(action="list", state="open")
934
+ - view: manage_prs(action="view", pr_numbers=[42])
935
+ - create: manage_prs(action="create", title="Feature X", head="feature-branch", base="main")
936
+ - create draft: manage_prs(action="create", title="WIP", head="wip-branch", draft=True)
937
+ - update: manage_prs(action="update", pr_numbers=[42], title="New title", body="Updated desc")
938
+ - merge: manage_prs(action="merge", pr_numbers=[42], merge_method="squash")
939
+ - close: manage_prs(action="close", pr_numbers=[42])
940
+ - reopen: manage_prs(action="reopen", pr_numbers=[42])
941
+ - comment: manage_prs(action="comment", pr_numbers=[42], body="LGTM!")
942
+ - request review: manage_prs(action="request_reviewers", pr_numbers=[42], reviewers=["user1"])
943
+ - approve: manage_prs(action="review", pr_numbers=[42], review_event="APPROVE", body="Looks good!")
944
+ - to draft: manage_prs(action="to_draft", pr_numbers=[42])
945
+ - ready: manage_prs(action="ready_for_review", pr_numbers=[42])
946
+ - add labels: manage_prs(action="add_labels", pr_numbers=[42], labels=["bug", "urgent"])
947
+ - remove labels: manage_prs(action="remove_labels", pr_numbers=[42], labels=["wip"])
948
+ - add assignees: manage_prs(action="add_assignees", pr_numbers=[42], assignees=["user1"])
949
+ - remove assignees: manage_prs(action="remove_assignees", pr_numbers=[42], assignees=["user1"])
950
+ """
951
+ try:
952
+ client = _get_client()
953
+
954
+ # === LIST ACTION ===
955
+ if action == "list":
956
+ prs = client.list_prs(
957
+ owner=owner,
958
+ repo=repo,
959
+ state=state or "open",
960
+ limit=limit or 20,
961
+ detail_level="summary",
962
+ )
963
+ return {
964
+ "action": "list",
965
+ "state": state or "open",
966
+ "count": len(prs),
967
+ "prs": [pr.model_dump() for pr in prs],
968
+ }
969
+
970
+ # === CREATE ACTION ===
971
+ if action == "create":
972
+ if not title:
973
+ raise ToolError("'title' is required for 'create' action")
974
+ if not head:
975
+ raise ToolError(
976
+ "'head' (source branch) is required for 'create' action"
977
+ )
978
+
979
+ pr = client.create_pr(
980
+ title=title,
981
+ head=head,
982
+ base=base or "main",
983
+ body=body,
984
+ draft=draft or False,
985
+ owner=owner,
986
+ repo=repo,
987
+ )
988
+
989
+ result = {
990
+ "action": "created",
991
+ "pr": pr.model_dump(),
992
+ }
993
+
994
+ # Auto-assign to self if assignees not specified
995
+ pr_assignees = assignees
996
+ if pr_assignees is None:
997
+ # Default to current user
998
+ current_user = client.get_authenticated_user()
999
+ if current_user:
1000
+ pr_assignees = [current_user]
1001
+
1002
+ if pr_assignees:
1003
+ try:
1004
+ assign_result = client.add_pr_assignees(
1005
+ pr.number, assignees=pr_assignees, owner=owner, repo=repo
1006
+ )
1007
+ result["assignees"] = assign_result["assignees"]
1008
+ except Exception as e:
1009
+ result["assignee_error"] = str(e)
1010
+
1011
+ return result
1012
+
1013
+ # === ALL OTHER ACTIONS REQUIRE pr_numbers ===
1014
+ if not pr_numbers:
1015
+ raise ToolError(f"'pr_numbers' required for '{action}' action")
1016
+
1017
+ results = []
1018
+ for pr_number in pr_numbers:
1019
+ # === VIEW ACTION ===
1020
+ if action == "view":
1021
+ pr_data = client.get_pr(
1022
+ pr_number=pr_number,
1023
+ owner=owner,
1024
+ repo=repo,
1025
+ )
1026
+ if pr_data:
1027
+ results.append(pr_data.model_dump())
1028
+ else:
1029
+ results.append({"number": pr_number, "error": "PR not found"})
1030
+
1031
+ # === UPDATE ACTION ===
1032
+ elif action == "update":
1033
+ pr_data = client.update_pr(
1034
+ pr_number=pr_number,
1035
+ title=title,
1036
+ body=body,
1037
+ base=base,
1038
+ owner=owner,
1039
+ repo=repo,
1040
+ )
1041
+ results.append(
1042
+ {
1043
+ "number": pr_number,
1044
+ "status": "updated",
1045
+ "pr": pr_data.model_dump(),
1046
+ }
1047
+ )
1048
+
1049
+ # === MERGE ACTION ===
1050
+ elif action == "merge":
1051
+ merge_result = client.merge_pr(
1052
+ pr_number=pr_number,
1053
+ merge_method=merge_method or "merge",
1054
+ owner=owner,
1055
+ repo=repo,
1056
+ )
1057
+ results.append(
1058
+ {
1059
+ "number": pr_number,
1060
+ "status": "merged" if merge_result["merged"] else "failed",
1061
+ "message": merge_result["message"],
1062
+ "sha": merge_result["sha"],
1063
+ }
1064
+ )
1065
+
1066
+ # === CLOSE ACTION ===
1067
+ elif action == "close":
1068
+ client.close_pr(pr_number, owner=owner, repo=repo)
1069
+ results.append({"number": pr_number, "status": "closed"})
1070
+
1071
+ # === REOPEN ACTION ===
1072
+ elif action == "reopen":
1073
+ client.reopen_pr(pr_number, owner=owner, repo=repo)
1074
+ results.append({"number": pr_number, "status": "reopened"})
1075
+
1076
+ # === COMMENT ACTION ===
1077
+ elif action == "comment":
1078
+ if not body:
1079
+ raise ToolError("'body' is required for 'comment' action")
1080
+ comment = client.add_pr_comment(
1081
+ pr_number, body=body, owner=owner, repo=repo
1082
+ )
1083
+ results.append(
1084
+ {
1085
+ "number": pr_number,
1086
+ "status": "commented",
1087
+ "comment_url": comment["html_url"],
1088
+ }
1089
+ )
1090
+
1091
+ # === REQUEST REVIEWERS ACTION ===
1092
+ elif action == "request_reviewers":
1093
+ if not reviewers and not team_reviewers:
1094
+ raise ToolError(
1095
+ "'reviewers' or 'team_reviewers' required for 'request_reviewers' action"
1096
+ )
1097
+ review_result = client.request_reviewers(
1098
+ pr_number,
1099
+ reviewers=reviewers,
1100
+ team_reviewers=team_reviewers,
1101
+ owner=owner,
1102
+ repo=repo,
1103
+ )
1104
+ results.append(
1105
+ {
1106
+ "number": pr_number,
1107
+ "status": "reviewers_requested",
1108
+ "requested_reviewers": review_result["requested_reviewers"],
1109
+ "requested_teams": review_result["requested_teams"],
1110
+ }
1111
+ )
1112
+
1113
+ # === REVIEW ACTION ===
1114
+ elif action == "review":
1115
+ if not review_event:
1116
+ raise ToolError(
1117
+ "'review_event' (APPROVE, REQUEST_CHANGES, COMMENT) required for 'review' action"
1118
+ )
1119
+ if review_event == "REQUEST_CHANGES" and not body:
1120
+ raise ToolError("'body' is required when requesting changes")
1121
+ review_result = client.submit_pr_review(
1122
+ pr_number,
1123
+ event=review_event,
1124
+ body=body,
1125
+ owner=owner,
1126
+ repo=repo,
1127
+ )
1128
+ results.append(
1129
+ {
1130
+ "number": pr_number,
1131
+ "status": "reviewed",
1132
+ "review_state": review_result["state"],
1133
+ "review_url": review_result["html_url"],
1134
+ }
1135
+ )
1136
+
1137
+ # === TO DRAFT ACTION ===
1138
+ elif action == "to_draft":
1139
+ draft_result = client.convert_pr_to_draft(
1140
+ pr_number, owner=owner, repo=repo
1141
+ )
1142
+ results.append(
1143
+ {
1144
+ "number": pr_number,
1145
+ "status": "converted_to_draft",
1146
+ "is_draft": draft_result["is_draft"],
1147
+ "message": draft_result["message"],
1148
+ }
1149
+ )
1150
+
1151
+ # === READY FOR REVIEW ACTION ===
1152
+ elif action == "ready_for_review":
1153
+ ready_result = client.mark_pr_ready_for_review(
1154
+ pr_number, owner=owner, repo=repo
1155
+ )
1156
+ results.append(
1157
+ {
1158
+ "number": pr_number,
1159
+ "status": "marked_ready",
1160
+ "is_draft": ready_result["is_draft"],
1161
+ "message": ready_result["message"],
1162
+ }
1163
+ )
1164
+
1165
+ # === ADD LABELS ACTION ===
1166
+ elif action == "add_labels":
1167
+ if not labels:
1168
+ raise ToolError("'labels' is required for 'add_labels' action")
1169
+ label_result = client.add_pr_labels(
1170
+ pr_number, labels=labels, owner=owner, repo=repo
1171
+ )
1172
+ results.append(
1173
+ {
1174
+ "number": pr_number,
1175
+ "status": "labels_added",
1176
+ "labels": label_result["labels"],
1177
+ }
1178
+ )
1179
+
1180
+ # === REMOVE LABELS ACTION ===
1181
+ elif action == "remove_labels":
1182
+ if not labels:
1183
+ raise ToolError(
1184
+ "'labels' is required for 'remove_labels' action"
1185
+ )
1186
+ label_result = client.remove_pr_labels(
1187
+ pr_number, labels=labels, owner=owner, repo=repo
1188
+ )
1189
+ results.append(
1190
+ {
1191
+ "number": pr_number,
1192
+ "status": "labels_removed",
1193
+ "labels": label_result["labels"],
1194
+ }
1195
+ )
1196
+
1197
+ # === ADD ASSIGNEES ACTION ===
1198
+ elif action == "add_assignees":
1199
+ if not assignees:
1200
+ raise ToolError(
1201
+ "'assignees' is required for 'add_assignees' action"
1202
+ )
1203
+ assign_result = client.add_pr_assignees(
1204
+ pr_number, assignees=assignees, owner=owner, repo=repo
1205
+ )
1206
+ results.append(
1207
+ {
1208
+ "number": pr_number,
1209
+ "status": "assignees_added",
1210
+ "assignees": assign_result["assignees"],
1211
+ }
1212
+ )
1213
+
1214
+ # === REMOVE ASSIGNEES ACTION ===
1215
+ elif action == "remove_assignees":
1216
+ if not assignees:
1217
+ raise ToolError(
1218
+ "'assignees' is required for 'remove_assignees' action"
1219
+ )
1220
+ assign_result = client.remove_pr_assignees(
1221
+ pr_number, assignees=assignees, owner=owner, repo=repo
1222
+ )
1223
+ results.append(
1224
+ {
1225
+ "number": pr_number,
1226
+ "status": "assignees_removed",
1227
+ "assignees": assign_result["assignees"],
1228
+ }
1229
+ )
1230
+
1231
+ else:
1232
+ raise ToolError(f"Invalid action: {action}")
1233
+
1234
+ # Return format depends on action
1235
+ if action == "view":
1236
+ return {
1237
+ "action": "view",
1238
+ "count": len(results),
1239
+ "prs": results,
1240
+ }
1241
+
1242
+ return {"action": action, "count": len(results), "results": results}
1243
+
1244
+ except ToolError:
1245
+ raise
1246
+ except ValueError as e:
1247
+ raise ToolError(f"Repository not specified: {str(e)}")
1248
+ except Exception as e:
1249
+ raise ToolError(f"Failed to {action} PR(s): {str(e)}")
1250
+
853
1251
  @mcp.tool(tags={"github", "prs", "appraisal"})
854
1252
  def prepare_appraisal_data(
855
1253
  author: Optional[str] = Field(
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: quickcall-integrations
3
- Version: 0.4.0
3
+ Version: 0.5.0
4
4
  Summary: MCP server with developer integrations for Claude Code and Cursor
5
5
  Requires-Python: >=3.10
6
6
  Requires-Dist: fastmcp>=2.13.0
@@ -90,7 +90,7 @@ Add to MCP config (`~/.cursor/mcp.json` or `.cursor/mcp.json`):
90
90
  | **Slack** | Read/send messages, threads, channels | Yes |
91
91
 
92
92
  <details>
93
- <summary><strong>Available Tools (24)</strong></summary>
93
+ <summary><strong>Available Tools (26)</strong></summary>
94
94
 
95
95
  ### Git
96
96
  | Tool | Description |
@@ -107,6 +107,8 @@ Add to MCP config (`~/.cursor/mcp.json` or `.cursor/mcp.json`):
107
107
  | `get_commit` | Get commit details (message, stats, files) |
108
108
  | `list_branches` | List repository branches |
109
109
  | `manage_issues` | List, view, create, update, close, reopen, comment on issues + sub-issues |
110
+ | `manage_prs` | Full PR lifecycle: create, update, merge, close, review, comment, labels, assignees |
111
+ | `manage_projects` | GitHub Projects V2: add issues, update fields (Status, Priority, etc.) |
110
112
  | `check_github_connection` | Verify GitHub connection |
111
113
 
112
114
  ### Slack
@@ -193,6 +195,8 @@ GITHUB_USERNAME=your-username # Optional: for better UX
193
195
  | `/quickcall:status` | Show connection status |
194
196
  | `/quickcall:updates` | Get git updates (default: 1 day) |
195
197
  | `/quickcall:updates 7d` | Get updates for last 7 days |
198
+ | `/quickcall:pr-summary` | List open PRs for a repo |
199
+ | `/quickcall:pr-summary owner/repo` | List PRs for specific repo |
196
200
  | `/quickcall:slack-summary` | Summarize Slack messages (default: 1 day) |
197
201
  | `/quickcall:slack-summary 7d` | Summarize last 7 days |
198
202
 
@@ -327,6 +331,46 @@ Create a bug report issue titled "Login fails on Safari"
327
331
  Create issue with feature_request template
328
332
  ```
329
333
 
334
+ ## PR Management
335
+
336
+ The `manage_prs` tool provides full pull request lifecycle management:
337
+
338
+ ### Actions
339
+
340
+ | Action | Description |
341
+ |--------|-------------|
342
+ | `list` | List PRs with state filter |
343
+ | `view` | View PR details |
344
+ | `create` | Create PR (auto-assigns to self) |
345
+ | `update` | Update title, body, base branch |
346
+ | `merge` | Merge PR (merge/squash/rebase) |
347
+ | `close` | Close PR without merging |
348
+ | `reopen` | Reopen closed PR |
349
+ | `comment` | Add comment to PR |
350
+ | `request_reviewers` | Request user/team reviewers |
351
+ | `review` | Submit review (APPROVE, REQUEST_CHANGES, COMMENT) |
352
+ | `to_draft` | Convert PR to draft |
353
+ | `ready_for_review` | Mark draft as ready |
354
+ | `add_labels` | Add labels to PR |
355
+ | `remove_labels` | Remove labels from PR |
356
+ | `add_assignees` | Add assignees |
357
+ | `remove_assignees` | Remove assignees |
358
+
359
+ ### Examples
360
+
361
+ ```
362
+ List open PRs on my-repo
363
+ Create a PR from feature-branch to main titled "Add new feature"
364
+ Merge PR #42 with squash
365
+ Request review from @alice on PR #42
366
+ Approve PR #42 with comment "LGTM!"
367
+ Add labels bug and urgent to PR #42
368
+ ```
369
+
370
+ ### Auto-assign
371
+
372
+ When creating a PR, it automatically assigns to the current user unless `assignees` is explicitly provided.
373
+
330
374
  ## Troubleshooting
331
375
 
332
376
  ### Clean Reinstall
@@ -1,7 +1,7 @@
1
1
  mcp_server/__init__.py,sha256=6KGzjSPyVB6vQh150DwBjINM_CsZNDhOzwSQFWpXz0U,301
2
2
  mcp_server/server.py,sha256=kv5hh0J-M7yENUBBNI1bkq1y7MB0zn5R_-R1tib6_sk,3108
3
3
  mcp_server/api_clients/__init__.py,sha256=kOG5_sxIVpAx_tvf1nq_P0QCkqojAVidRE-wenLS-Wc,207
4
- mcp_server/api_clients/github_client.py,sha256=Y3P2yRRv8GxG0xjql6IaVB5aodGDeTPQUC_lHQmgVWM,70829
4
+ mcp_server/api_clients/github_client.py,sha256=kwqwZN1UeClQqdE7n3Nv9Mc4RS1dtNvSgCO9yCaGCaw,86256
5
5
  mcp_server/api_clients/slack_client.py,sha256=w3rcGghttfYw8Ird2beNo2LEYLc3rCTbUKMH4X7QQuQ,16447
6
6
  mcp_server/auth/__init__.py,sha256=D-JS0Qe7FkeJjYx92u_AqPx8ZRoB3dKMowzzJXlX6cc,780
7
7
  mcp_server/auth/credentials.py,sha256=sDS0W5c16i_UGvhG8Sh1RO93FxRn-hHVAdI9hlWuhx0,20011
@@ -12,10 +12,10 @@ mcp_server/resources/slack_resources.py,sha256=b_CPxAicwkF3PsBXIat4QoLbDUHM2g_iP
12
12
  mcp_server/tools/__init__.py,sha256=vIR2ujAaTXm2DgpTsVNz3brI4G34p-Jeg44Qe0uvWc0,405
13
13
  mcp_server/tools/auth_tools.py,sha256=BPuj9M0pZOvvWHxH0HPdiVm-Y6DJyD-PEvtrIh68vbc,25409
14
14
  mcp_server/tools/git_tools.py,sha256=jyCTQR2eSzUFXMt0Y8x66758-VY8YCY14DDUJt7GY2U,13957
15
- mcp_server/tools/github_tools.py,sha256=U1auskC17nJWVmqFO9EITe-OcDSeDBuhM3d4iox7Ix8,50007
15
+ mcp_server/tools/github_tools.py,sha256=heVaftmWbeAAhJRS0YlE0BjtnjbFQbcExS9O4F7hI9o,66804
16
16
  mcp_server/tools/slack_tools.py,sha256=-HVE_x3Z1KMeYGi1xhyppEwz5ZF-I-ZD0-Up8yBeoYE,11796
17
17
  mcp_server/tools/utility_tools.py,sha256=oxAXpdqtPeB5Ug5dvk54V504r-8v1AO4_px-sO6LFOw,3910
18
- quickcall_integrations-0.4.0.dist-info/METADATA,sha256=pOcoe0a2JKylPL6tpzYk2lUor_hgfsXPyDgjwjn45JM,9415
19
- quickcall_integrations-0.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
20
- quickcall_integrations-0.4.0.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
21
- quickcall_integrations-0.4.0.dist-info/RECORD,,
18
+ quickcall_integrations-0.5.0.dist-info/METADATA,sha256=5_sYSB2zIJrzh4heXS2EUooYCHKbOYmEoZN6_xuI4R4,10936
19
+ quickcall_integrations-0.5.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
20
+ quickcall_integrations-0.5.0.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
21
+ quickcall_integrations-0.5.0.dist-info/RECORD,,