# Directory Structure

```
├── .gitignore
├── .python-version
├── main.py
├── pyproject.toml
├── README.md
└── uv.lock
```

# Files

--------------------------------------------------------------------------------
/.python-version:
--------------------------------------------------------------------------------

```
3.11

```

--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------

```
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
share/python-wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST

# PyInstaller
#  Usually these files are written by a python script from a template
#  before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.nox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
*.py,cover
.hypothesis/
.pytest_cache/
cover/

# Translations
*.mo
*.pot

# Django stuff:
*.log
local_settings.py
db.sqlite3
db.sqlite3-journal

# Flask stuff:
instance/
.webassets-cache

# Scrapy stuff:
.scrapy

# Sphinx documentation
docs/_build/

# PyBuilder
.pybuilder/
target/

# Jupyter Notebook
.ipynb_checkpoints

# IPython
profile_default/
ipython_config.py

# pyenv
#   For a library or package, you might want to ignore these files since the code is
#   intended to run in multiple environments; otherwise, check them in:
# .python-version

# pipenv
#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
#   However, in case of collaboration, if having platform-specific dependencies or dependencies
#   having no cross-platform support, pipenv may install dependencies that don't work, or not
#   install all needed dependencies.
#Pipfile.lock

# UV
#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
#   This is especially recommended for binary packages to ensure reproducibility, and is more
#   commonly ignored for libraries.
#uv.lock

# poetry
#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
#   This is especially recommended for binary packages to ensure reproducibility, and is more
#   commonly ignored for libraries.
#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
#poetry.lock

# pdm
#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
#pdm.lock
#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
#   in version control.
#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
.pdm.toml
.pdm-python
.pdm-build/

# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
__pypackages__/

# Celery stuff
celerybeat-schedule
celerybeat.pid

# SageMath parsed files
*.sage.py

# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/
.dmypy.json
dmypy.json

# Pyre type checker
.pyre/

# pytype static type analyzer
.pytype/

# Cython debug symbols
cython_debug/

# PyCharm
#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
#  and can be added to the global gitignore or merged into this file.  For a more nuclear
#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
#.idea/

# Ruff stuff:
.ruff_cache/

# PyPI configuration file
.pypirc

```

--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------

```markdown
# twilio-mcp-python

This is a Twilio MCP server!

Usage:

Two tools currently:

send_message and get_message_logs

Future Work:

Need to add prompts and call features

```

--------------------------------------------------------------------------------
/pyproject.toml:
--------------------------------------------------------------------------------

```toml
[project]
name = "twilio"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
requires-python = ">=3.11"
dependencies = [
    "mcp[cli]>=1.4.1",
]

```

--------------------------------------------------------------------------------
/main.py:
--------------------------------------------------------------------------------

```python
from dotenv import load_dotenv
from mcp.server.fastmcp import FastMCP
from twilio.rest import Client

from typing import Annotated

from pydantic import BeforeValidator
from pydantic_settings import BaseSettings, SettingsConfigDict

#import pydantic
#from icecream import ic


load_dotenv()

class Credentials(BaseSettings):

  account_sid: str | None = None
  auth_token: str | None = None
  phone_number: Annotated[
    str, 
    BeforeValidator(lambda v: v if v.startswith("+") else f"+{v}")
  ]

  
  model_config: SettingsConfigDict = SettingsConfigDict(
      env_prefix = "TWILIO_",
      env_file = ".env",
      env_file_encoding = "utf-8"
  )


try:  
  credentials = Credentials()
  client = Client(credentials.account_sid, credentials.auth_token)

  mcp = FastMCP(
      name="twilioServer", 
      dependencies=["twilio", "python-dotenv", "pydantic", "typing"],
      description="A server that sends a message using Twilio",
      version="0.0.1"
      )

except Exception as e: 
  print(f"Error: {e}")
  exit(1)


@mcp.tool(name='textme', description='Send a text message using Twilio')
def send_message(to: str=credentials.phone_number, message: str="Hello world"):
  """
  Sends a message to a phone number using Twilio
  """
  try:
    message = client.messages.create(
      messaging_service_sid='MG67808210bf00bd0d6bbfece0cf6075e6',
      body=message,
      to=to
    )
    
    return [
      f"Message sent to {to}",
      message.sid,
    ]
  except Exception as e:
    return[
      f'Error sending message: {e}'
    ]

@mcp.tool(name="msglogs", description="get the message logs for a number")
def get_message_logs(phone_number: str=credentials.phone_number, limit: int=10):
    """
    Retrieves message logs for a specific phone number.
    """
    messages = client.messages.list(to=phone_number, limit=limit)  # Last 10 messages
    
    if not messages:
        print(f"No messages found for {phone_number}")
        return
    
    for msg in messages:
        print(f"SID: {msg.sid} | Status: {msg.status} | Sent At: {msg.date_sent} | Body: {msg.body}")









```