Skip to main content
Version: 1.7.3

Remote Model Context Protocol (MCP) Server

The Remote Model Context Protocol (MCP) server is a state-of-the-art solution developed by TaxBandits to revolutionize the way tax processing is handled. It integrates artificial intelligence (AI) with tax automation through the MCP framework, allowing you to interact with the system via natural language, reducing the need for manual form-filling and administrative tasks.

With the Remote MCP server, you can issue simple, conversational commands, and the system automatically processes the relevant tax forms and submits them to the IRS, all with minimal input from you.

Key features​

  • Zero Installation: No local setup is required. Just add a line to your configuration and start processing.
  • Universal Platform Support: Compatible with desktop, web-based tools, and mobile devices.
  • Enterprise Security: All data is processed on our secure production-grade infrastructure with encryption and compliance built in.

Getting Started with the TaxBandits Remote MCP Server​

Integrating with the TaxBandits MCP Server is quick and easy. Follow the steps below to get started.

1. Get Your API Credentials​

You can directly obtain your Client ID and MCP API Key from the TaxBandits Developer Console: sandbox.taxbandits.com

2. Configure Your MCP Client​

Use your credentials to connect your preferred MCP-compatible tool (such as Cursor, Cline, or any SSE transport-compatible client) to the TaxBandits MCP Server.

Here’s an example configuration:

{
    "mcpServers": {
        "taxbandits_mcp": {
            "url": "https://ai-pubapimcp.spanllc.com/sse?authentication=CLIENT_ID,MCP_API_KEY"
        }
    }
}

3. Validate the Connection​

Ensure that your client successfully authenticates and connects to the MCP Server before proceeding with workflows.

4. Start Using AI-Powered Tax Automation​

Once connected, you can start using the MCP Server through your client tools.

Try prompts like:

"Add a new contractor and request their W-9."

"Check which contractors haven’t submitted W-9 forms."

"Generate year-end 1099 forms for all contractors."

"Submit my 1099 forms to the IRS."

Authentication​

TaxBandits MCP server uses OAuth 2.1 for secure authentication and API access.

  1. Client Authentication: You authenticate via an MCP API Key for client access.
  2. OAuth Authentication: Use OAuth 2.1 with automatic token refresh to authenticate against the TaxBandits API.
  3. Rate Limiting and Session Management: Your requests are rate-limited to ensure fair usage and prevent abuse. The OAuth token refresh system handles token expiration seamlessly.

Available tools & functions​

The following functions are available for integration with the TaxBandits Remote MCP server:

Business Management Tools​

  • create_business: Add a new business to the TaxBandits API.

W-9 Form Processing​

  • request_w9_by_email: Send W-9 certificate requests via email with custom templates.
  • get_w9_status: Track W-9 form completion status in real-time.
  • get_w9: Download completed W-9 forms for secure storage.
  • list_w9: List all W9s under a particular business with optional filtering.

1099-NEC Form Management​

  • create_1099_nec: Generate 1099-NEC forms for contractors, automatically calculating payments and thresholds.
  • validate_1099_nec: Validate the form before submission, detecting any errors.
  • transmit_1099_nec: Submit 1099-NEC forms to the IRS and states.
  • get_1099_nec_pdf: Download the generated 1099-NEC forms as PDFs.
  • request_pdf_urls_1099_nec: Retrieve PDF URLs for single or multiple 1099-NEC recipients.

Rate Limiting​

To ensure the API performs efficiently for both low- and high-volume users, we’ve implemented multi-tier rate limiting:

  1. Standard Rate Limiting: For everyday users, restricting the number of requests per minute.
  2. High-Volume Rate Limiting: For business users with higher volumes, enabling enhanced performance without throttling.

Error Handling​

TaxBandits MCP server has robust error-handling mechanisms to ensure seamless integration and efficient issue resolution:

  1. Authentication Errors: Ensure that your API key and OAuth token are valid. Invalid credentials result in a 401 Unauthorized error.
  2. Rate Limiting Errors: When the rate limit is exceeded, a 429 Too Many Requests error is returned, instructing you to retry later.
  3. Validation Errors: If you submit incorrect data or an invalid form, a detailed error message with suggestions for correction is returned.
  4. Internal Server Errors: In case of system failures, a 500 Internal Server Error will be logged, and you’ll be informed of the issue.

Security and Compliance​

TaxBandits MCP server is designed with enterprise-grade security and regulatory compliance features:

  • Data Encryption: All sensitive data is encrypted at rest and in transit using TLS 1.3.
  • Access Control: Multi-factor authentication and IP tracking ensure secure access to the system.
  • Compliance: The system complies with IRS standards, GDPR, and SOC 2 security audits.