Skip to main content
Glama
revenuebase-mcp-server

revenuebase-mcp-server

by avivshafir

RevenueBase MCP 서버

업계 최고 수준의 RevenueBase 이메일 검증 API에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 비서와 애플리케이션은 캐치올 및 방화벽으로 보호되는 도메인을 포함한 비즈니스 이메일을 99% 이상의 정확도로 검증할 수 있습니다.

특징

  • 실시간 이메일 확인 : 개별 이메일 주소를 즉시 확인하세요

  • 일괄 이메일 처리 : 대량 이메일 목록 제출 및 처리

  • 프로세스 관리 : 일괄 처리 작업 모니터링, 취소 및 추적

  • 크레딧 관리 : API 크레딧 잔액 확인

  • API 키 관리 : 새로운 API 키 생성

  • 높은 정확도 : B2B 이메일 검증 시 99% 이상의 정확도

  • 포괄적 도메인 지원 : 다른 도구에서는 처리할 수 없는 포괄적 이메일 도메인을 확인합니다.

  • 방화벽 탐색 : Mimecast 및 Barracuda와 같은 이메일 방화벽을 우회합니다.

Related MCP server: json-mcp-server

RevenueBase 소개

RevenueBase는 B2B 데이터 제공업체를 위해 특별히 설계된 업계 최고의 이메일 검증 서비스를 제공합니다. 캐치올(Catch-all) 및 방화벽으로 보호되는 도메인을 검증하는 기능을 통해 RevenueBase는 다른 서비스가 미흡한 부분에서도 최고의 정확성을 보장합니다.

RevenueBase의 이메일 검증 서비스에 대해 자세히 알아보려면 https://revenuebase.ai/email-list-cleaning/을 방문하세요.

설치

  1. 이 저장소를 복제하세요:

지엑스피1

  1. uv를 사용하여 종속성을 설치합니다.

uv sync
  1. RevenueBase API 키를 설정하세요:

export REVENUEBASE_API_KEY="your_api_key_here"

용법

서버 실행

python server.py

서버가 시작되고 MCP 연결을 사용할 수 있게 됩니다.

MCP 클라이언트와 함께 사용

클로드 데스크탑

Claude Desktop과 함께 이 서버를 사용하려면 Claude Desktop 구성 파일에 다음 구성을 추가하세요.

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "revenuebase": {
      "command": "uv",
      "args": ["--directory", "/path/to/revenuebase-mcp-server", "run", "python", "server.py"],
      "env": {
        "REVENUEBASE_API_KEY": "your_api_key_here"
      }
    }
  }
}

/path/to/revenuebase-mcp-server 복제된 저장소의 실제 경로로 바꾸고 your_api_key_here 실제 RevenueBase API 키로 바꾸세요.

다른 MCP 클라이언트

다른 MCP 클라이언트의 경우 stdio 전송을 사용하여 서버에 연결할 수 있습니다. 서버는 표준 MCP 서버로 실행되며 stdin/stdout 연결을 허용합니다.

MCP Python SDK를 사용한 예:

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["server.py"],
    env={"REVENUEBASE_API_KEY": "your_api_key_here"}
)

async with stdio_client(server_params) as (read, write):
    async with ClientSession(read, write) as session:
        # Initialize the connection
        await session.initialize()
        
        # List available tools
        tools = await session.list_tools()
        print("Available tools:", [tool.name for tool in tools.tools])
        
        # Call a tool
        result = await session.call_tool("real_time_email_verification", {
            "email": "test@example.com"
        })
        print("Verification result:", result)

사용 가능한 도구

1. 실시간 이메일 확인

단일 이메일 주소를 즉시 확인하세요.

매개변수:

  • email (문자열): 확인할 이메일 주소

예:

real_time_email_verification("user@example.com")

2. 일괄 이메일 제출

일괄 이메일 처리를 위해 파일 참조를 제출하세요.

매개변수:

  • filename (문자열): 일괄 처리를 위한 파일 이름 참조

예:

batch_email_submission("email_list.csv")

3. 배치 프로세스 상태

일괄 이메일 처리 작업의 상태를 확인합니다.

매개변수:

  • process_id (int): 일괄 처리 작업의 ID

예:

batch_process_email_status(12345)

4. 대기 중인 프로세스

대기 중인 모든 이메일 일괄 처리 작업을 나열합니다.

예:

queued_process()

5. 취소 프로세스

진행 중이거나 대기 중인 일괄 이메일 처리 작업을 취소합니다.

매개변수:

  • process_id (int): 취소할 프로세스의 ID

예:

cancel_process(12345)

6. 크레딧을 받으세요

귀하의 계정에 남아 있는 크레딧 수를 검색합니다.

예:

get_credits()

7. 새로운 API 키 생성

새로운 API 키를 생성하여 반환합니다.

예:

new_api_key()

구성

환경 변수

  • REVENUEBASE_API_KEY : RevenueBase API 키(필수)

API 엔드포인트

서버는 다음 RevenueBase API 엔드포인트에 연결합니다.

  • https://api.revenuebase.ai/v1/process-email - 실시간 이메일 검증

  • https://api.revenuebase.ai/v1/batch-process-email - 일괄 이메일 제출

  • https://api.revenuebase.ai/v1/batch-process-email-status - 배치 상태 확인

  • https://api.revenuebase.ai/v1/queued-process - 대기 중인 프로세스 목록

  • https://api.revenuebase.ai/v1/cancel-process - 프로세스 취소

  • https://api.revenuebase.ai/v1/credits - 크레딧 받기

  • https://api.revenuebase.ai/v1/new-api-key - 새로운 API 키 생성

오류 처리

모든 도구에는 적절한 오류 처리 기능이 포함되어 있으며, API 키가 구성되지 않은 경우 RuntimeError 발생합니다. RevenueBase API의 HTTP 오류는 requests.raise_for_status() 사용하여 자동으로 발생합니다.

요구 사항

  • 파이썬 3.7 이상

  • 패스트MCP

  • 요청

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

지원하다

RevenueBase API 지원 및 설명서는 다음에서 확인하세요.

이 MCP 서버 관련 문제가 있는 경우 이 저장소에서 문제를 열어주세요.

Available Tools

7 tools
batch_email_submissionC

Submits a file reference for batch email processing using the Revenuebase API.

Inputs: filename (required).

batch_process_email_statusC

Retrieves status of batch email processing job.

Inputs: process_id (required).

cancel_processC

Cancels an ongoing or queued batch email processing job using the Revenuebase API.

Inputs: process_id (required).

get_creditsA

Retrieves the number of remaining credits for the authenticated user.

Inputs: no named parameters.

new_api_keyB

Generates and returns a new API key for the user.

Inputs: no named parameters.

queued_processB

Lists all queued email batch processing jobs.

Inputs: no named parameters.

real_time_email_verificationC

Verifies a single email address using the Revenuebase API.

Inputs: email (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: batch_email_submission initiates processing, batch_process_email_status checks status, cancel_process stops jobs, get_credits shows credits, new_api_key generates keys, queued_process lists jobs, and real_time_email_verification verifies single emails. The descriptions reinforce these distinct functions, making tool selection unambiguous.

    Naming Consistency5/5

    All tools follow a consistent snake_case naming pattern with clear verb-noun combinations (e.g., batch_email_submission, real_time_email_verification). The naming convention is uniform across all seven tools, making them predictable and easy to understand at a glance.

    Tool Count5/5

    With 7 tools, this server is well-scoped for email verification and batch processing tasks. Each tool serves a specific, necessary function in the workflow, from initiation to status checks and management, without being overly sparse or bloated.

    Completeness4/5

    The tool set covers core email verification and batch processing operations comprehensively, including submission, status retrieval, cancellation, credit management, and API key generation. A minor gap exists in lacking a tool for detailed results of completed batch jobs, but agents can work around this using the status tool.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers