callrail-mcp 1.0.0__tar.gz

callrail_mcp-1.0.0/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# All files require review by Steve Japalucci
+*       @pghdma

callrail_mcp-1.0.0/.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: [pghdma]
+custom: ["https://pghdma.com"]

callrail_mcp-1.0.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Something isn't working as documented
+title: "[Bug] "
+labels: bug
+assignees: ''
+---
+
+## Description
+
+A clear and concise description of what the bug is.
+
+## To reproduce
+
+Minimal steps. If possible, paste the tool invocation or Python snippet.
+
+## Expected behavior
+
+What you thought would happen.
+
+## Actual behavior
+
+What actually happened. Include error output if any — **redact your API key**.
+
+## Environment
+
+- `callrail-mcp` version:
+- Python version:
+- MCP client (Claude Code / Desktop / Cursor / other) + version:
+- OS:
+
+## Additional context
+
+Anything else relevant — related issues, docs you followed, etc.

callrail_mcp-1.0.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/pghdma/callrail-mcp/security/policy
+    about: Please report security issues privately via SECURITY.md, not as a public issue.
+  - name: Questions & general discussion
+    url: https://github.com/pghdma/callrail-mcp/discussions
+    about: Ask questions or share how you're using the project.

callrail_mcp-1.0.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,31 @@
+---
+name: Feature request
+about: Suggest a new tool or capability
+title: "[Feature] "
+labels: enhancement
+assignees: ''
+---
+
+## Use case
+
+What are you trying to do with your MCP client (Claude, Cursor, etc.)? Describe the real workflow — e.g. *"I want to ask Claude to list all missed calls from Google Ads that lasted under 10 seconds so we can flag ad-copy misfires."*
+
+## Proposed tool / API surface
+
+If you have a specific tool signature in mind, sketch it:
+
+```python
+@mcp.tool()
+def new_tool(arg: str, ...) -> str:
+    """What it does."""
+```
+
+Or describe the CallRail API endpoint you'd like wrapped (see <https://apidocs.callrail.com/>).
+
+## Alternatives considered
+
+What workarounds exist today? What's wrong with them?
+
+## Additional context
+
+Links, screenshots, related issues.

callrail_mcp-1.0.0/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "chore(deps)"
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: monthly
+    commit-message:
+      prefix: "chore(ci)"

callrail_mcp-1.0.0/.github/pull_request_template.md

@@ -0,0 +1,33 @@
+# Pull request
+
+## Summary
+
+What does this PR change? Keep it tight — one-liner is best.
+
+## Related issue(s)
+
+Closes #
+
+## Changes
+
+- [ ] ...
+- [ ] ...
+
+## Test plan
+
+How did you verify this works? Include commands if you ran them locally.
+
+- [ ] `pytest` passes
+- [ ] `ruff check src tests` passes
+- [ ] Tested manually against a real CallRail account (if applicable)
+
+## Checklist
+
+- [ ] Docs updated (README / docstrings) if the change affects user-facing API
+- [ ] `CHANGELOG.md` updated under `## [Unreleased]`
+- [ ] No secrets, API keys, or PII committed
+- [ ] Follows the code style enforced by `ruff`
+
+## Screenshots / output (optional)
+
+Paste any relevant output or screenshots.

callrail_mcp-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install package + dev extras
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint (ruff)
+        run: ruff check src tests
+
+      - name: Type check (mypy)
+        run: mypy src
+        continue-on-error: true  # non-blocking initially; tighten later
+
+      - name: Run tests
+        run: pytest -v

callrail_mcp-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/callrail-mcp
+    permissions:
+      id-token: write  # trusted publishing via OIDC
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install build
+        run: |
+          python -m pip install --upgrade pip build
+
+      - name: Build sdist + wheel
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

callrail_mcp-1.0.0/.gitignore

@@ -0,0 +1,58 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual envs
+.venv/
+venv/
+env/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+
+# Mypy / Ruff caches
+.mypy_cache/
+.ruff_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# OS
+.DS_Store
+
+# Secrets — never commit
+.env
+*.api-key
+callrail-api-key.txt