{% extends "docs/base.html" %}

{% block docs_content %}
  <div class="mb-4">
    <h1 class="h3 mb-1">get_pull_context</h1>
    <p class="text-muted mb-0">Get context for a pull request with reviews, the current user's review, and editability flags.</p>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Parameters</h2>
      <table class="table table-sm mb-0">
        <thead>
          <tr>
            <th>Name</th>
            <th>Type</th>
            <th>Required</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><code>repo</code></td>
            <td>string</td>
            <td>Yes</td>
            <td>Repository path. Format: <code>teams/team_slug/repo_slug</code> or <code>username/repo_slug</code>.</td>
          </tr>
          <tr>
            <td><code>pull_number</code></td>
            <td>integer</td>
            <td>Yes</td>
            <td>The pull request number to retrieve context for.</td>
          </tr>
        </tbody>
      </table>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Example</h2>
      <div class="bg-light border rounded p-3">
        <pre class="mb-0"><code>curl -X POST https://pearing.example/api/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_pull_context",
      "arguments": {
        "repo": "teams/acme/webapp",
        "pull_number": 7
      }
    }
  }'</code></pre>
      </div>
    </div>
  </div>

  <div class="card shadow-sm">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Response</h2>
      <p class="mb-0">Returns the pull request object, reviews with reviewer details, the authenticated user's existing review when present, attachment arrays inline on the pull and each review, and permission flags such as <code>can_update_content</code>, <code>can_update_refs</code>, and <code>can_merge</code>. Active attachments include upload detail and content links. The response is returned as a text content block inside the standard MCP tool result.</p>
    </div>
  </div>
{% endblock %}