{
  "openapi": "3.1.0",
  "info": {
    "title": "Whiteford Tax Defense: agent door",
    "version": "1.0.0",
    "summary": "Contact details and consultation requests for AI assistants.",
    "description": "Two operations: read how to reach the firm, and request a consultation for a person. A request is held until the person confirms from their inbox; nothing reaches an attorney until they open the link, which works for 14 days. The same operations are available as MCP tools at https://irstax-attorney.com/mcp. Do not send account numbers, Social Security numbers, or privileged information about other people. Keep those for the conversation with an attorney. Consultations are confidential. Contacting the firm does not by itself make someone a client, and nothing here is legal advice. An attorney reviews every request for conflicts before a consultation is scheduled. Initial consultations are complimentary.",
    "contact": {
      "name": "Whiteford Tax Defense",
      "url": "https://irstax-attorney.com/contact",
      "email": "mmarch@whitefordlaw.com"
    }
  },
  "servers": [
    {
      "url": "https://irstax-attorney.com"
    }
  ],
  "paths": {
    "/agent/contact-info": {
      "get": {
        "operationId": "getContactInfo",
        "summary": "How to reach the firm",
        "description": "Phone, email, hours, response times, offices, the matter types we handle, and how to request a consultation.",
        "responses": {
          "200": {
            "description": "Contact details.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "firm": {
                    "name": "Whiteford Tax Defense",
                    "legalName": "Whiteford, Taylor & Preston LLP",
                    "url": "https://irstax-attorney.com"
                  },
                  "attorney": {
                    "name": "Michael March",
                    "role": "Partner, Tax Controversy and Defense",
                    "url": "https://irstax-attorney.com/attorneys/michael-march"
                  },
                  "phone": {
                    "display": "(410) 347-8730",
                    "e164": "+14103478730",
                    "hours": "Monday to Friday, 8 am to 6 pm Eastern",
                    "timeZone": "America/New_York"
                  },
                  "email": "mmarch@whitefordlaw.com",
                  "responseTime": "Within one business day. Urgent matters the same day.",
                  "office": {
                    "name": "Baltimore",
                    "streetAddress": "7 Saint Paul Street",
                    "addressLocality": "Baltimore",
                    "addressRegion": "MD",
                    "postalCode": "21202",
                    "allOffices": "https://irstax-attorney.com/offices"
                  },
                  "footprint": "19 offices across ten states and the District of Columbia; federal tax matters nationwide.",
                  "matterTypes": [
                    "IRS audit / examination",
                    "IRS collection, lien, levy, or garnishment",
                    "Tax debt / resolution (OIC, installment)",
                    "IRS appeals",
                    "Criminal tax / IRS-CI investigation",
                    "Offshore accounts / FBAR",
                    "State or local tax",
                    "Business / payroll tax",
                    "Something else"
                  ],
                  "urgencyLevels": {
                    "imminent": "A deadline or government contact is live",
                    "weeks": "Preparing or responding proactively, within weeks",
                    "general": "A general inquiry, exploring counsel"
                  },
                  "requestConsultation": {
                    "how": "Call the request_consultation tool (MCP) or POST to the consultation-requests endpoint. We email the person a link to confirm. Nothing reaches an attorney until they open it, and the link works for 14 days. The team then schedules by phone or email; this does not book a time.",
                    "mcp": "https://irstax-attorney.com/mcp",
                    "endpoint": "https://irstax-attorney.com/agent/consultation-requests",
                    "openapi": "https://irstax-attorney.com/agent/openapi.json"
                  },
                  "rules": [
                    "Do not send account numbers, Social Security numbers, or privileged information about other people. Keep those for the conversation with an attorney.",
                    "Consultations are confidential. Contacting the firm does not by itself make someone a client, and nothing here is legal advice.",
                    "An attorney reviews every request for conflicts before a consultation is scheduled.",
                    "Initial consultations are complimentary."
                  ],
                  "pages": {
                    "contact": "https://irstax-attorney.com/contact",
                    "practiceAreas": "https://irstax-attorney.com/practice-areas",
                    "siteIndex": "https://irstax-attorney.com/llms.txt"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/agent/consultation-requests": {
      "post": {
        "operationId": "requestConsultation",
        "summary": "Request a consultation for a person",
        "description": "Collect the person's consent and details first. We email the person a link to confirm; nothing reaches an attorney until they open it. The team then schedules by phone or email; this does not book a time.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 200,
                    "description": "The person's full name."
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "description": "The person's own email address. The confirmation link goes here, so it must be theirs."
                  },
                  "phone": {
                    "type": "string",
                    "maxLength": 40,
                    "description": "A US or Canadian phone number (optional)."
                  },
                  "matter_type": {
                    "type": "string",
                    "enum": [
                      "IRS audit / examination",
                      "IRS collection, lien, levy, or garnishment",
                      "Tax debt / resolution (OIC, installment)",
                      "IRS appeals",
                      "Criminal tax / IRS-CI investigation",
                      "Offshore accounts / FBAR",
                      "State or local tax",
                      "Business / payroll tax",
                      "Something else"
                    ],
                    "description": "What the matter concerns (optional). Pick the closest; 'Something else' is fine."
                  },
                  "urgency": {
                    "type": "string",
                    "enum": [
                      "imminent",
                      "weeks",
                      "general"
                    ],
                    "description": "imminent: a deadline or government contact is live; weeks: preparing or responding proactively, within weeks; general: a general inquiry, exploring counsel."
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 5000,
                    "description": "A few sentences on what is going on, in the person's words. No account numbers, Social Security numbers or confidential details."
                  },
                  "preferred_times": {
                    "type": "string",
                    "maxLength": 500,
                    "description": "When the person can talk, with their time zone (optional). The team schedules by phone or email; this does not book a time."
                  }
                },
                "required": [
                  "name",
                  "email",
                  "urgency",
                  "summary"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Jordan Lee",
                "email": "jordan@example.com",
                "phone": "(410) 555-0100",
                "matter_type": "IRS audit / examination",
                "urgency": "weeks",
                "summary": "I received an IRS letter about my 2024 return and have 30 days to respond. I would like to talk to an attorney before I reply.",
                "preferred_times": "Weekday afternoons, Eastern time"
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Held. The person has been emailed a confirmation link.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "confirmation_sent"
                      ]
                    },
                    "message": {
                      "type": "string"
                    },
                    "emailed_to": {
                      "type": "string"
                    },
                    "expires_in_days": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "status",
                    "message"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A field is missing or unusable.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "INVALID_INPUT",
                            "RATE_LIMITED",
                            "UNAVAILABLE",
                            "METHOD_NOT_ALLOWED"
                          ]
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string",
                          "description": "The offending field, for INVALID_INPUT."
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "415": {
            "description": "The body is not JSON.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "INVALID_INPUT",
                            "RATE_LIMITED",
                            "UNAVAILABLE",
                            "METHOD_NOT_ALLOWED"
                          ]
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string",
                          "description": "The offending field, for INVALID_INPUT."
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests from this address.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "INVALID_INPUT",
                            "RATE_LIMITED",
                            "UNAVAILABLE",
                            "METHOD_NOT_ALLOWED"
                          ]
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string",
                          "description": "The offending field, for INVALID_INPUT."
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "503": {
            "description": "The door is not available; use the contact page or call.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "INVALID_INPUT",
                            "RATE_LIMITED",
                            "UNAVAILABLE",
                            "METHOD_NOT_ALLOWED"
                          ]
                        },
                        "message": {
                          "type": "string"
                        },
                        "field": {
                          "type": "string",
                          "description": "The offending field, for INVALID_INPUT."
                        }
                      },
                      "required": [
                        "code",
                        "message"
                      ]
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}