Skip to main content
Glama

ENS MCP 서버

클로드가 ENS 시스템과 상호 작용하여 이름을 확인하고, 가용성을 확인하고, 레코드를 검색하는 등의 작업을 수행할 수 있도록 하는 Ethereum 이름 서비스(ENS)용 MCP 서버입니다.

npm 패키지: https://www.npmjs.com/package/mcp-server-ens

도구

해결 이름

ENS 이름을 Ethereum 주소로 변환

  • 필수 입력 사항:

    • name (문자열): 확인할 ENS 이름(예: 'vitalik.eth')

  • 반환: 해당 Ethereum 주소 또는 오류 메시지

역방향 조회

Ethereum 주소에 대한 ENS 이름을 가져옵니다.

  • 필수 입력 사항:

    • address (문자열): 조회할 Ethereum 주소

  • 반환: 해당 ENS 이름 또는 이름을 찾을 수 없음을 나타냅니다.

텍스트 레코드 가져오기

ENS 이름에 대한 텍스트 레코드 가져오기

  • 필수 입력 사항:

    • name (문자열): 쿼리할 ENS 이름

    • key (문자열): 조회할 레코드 키(예: '이메일', 'url', '아바타', '설명', 'twitter' 등)

  • 반환: 지정된 텍스트 레코드의 값 또는 레코드를 찾을 수 없음을 나타냅니다.

예약 가능 여부 확인

ENS 이름을 등록할 수 있는지 확인하세요

  • 필수 입력 사항:

    • name (문자열): 확인할 ENS 이름

  • 반환: 등록된 경우 가용성 상태 및 소유자 정보

모든 레코드 가져오기

ENS 이름에 대한 모든 사용 가능한 정보를 얻으세요

  • 필수 입력 사항:

    • name (문자열): 쿼리할 ENS 이름

  • 반환: 확인자 주소, 텍스트 레코드, 주소, 콘텐츠 해시, 소유권 및 만료 세부 정보를 포함한 포괄적인 정보

하위 도메인 가져오기

ENS 이름에 대한 하위 도메인 가져오기

  • 필수 입력 사항:

    • name (문자열): 하위 도메인을 쿼리할 ENS 이름

  • 반환: 소유자 정보가 포함된 하위 도메인 목록

get-name-history

ENS 이름의 역사를 알아보세요

  • 필수 입력 사항:

    • name (문자열): 기록을 확인할 ENS 이름

  • 반환: 전송, 확인자 변경 및 등록 이벤트를 포함한 이름과 관련된 기록 이벤트

등록 가격 받기

ENS 이름 등록 가격을 알아보세요

  • 필수 입력 사항:

    • name (문자열): 가격을 확인할 ENS 이름

  • 선택 입력 사항:

    • duration (숫자, 기본값: 1): 등록 기간(년)

  • 반환: 기본 가격, 프리미엄 및 총액을 포함한 등록 가격 세부 정보

Related MCP server: MCP Crypto Wallet EVM

설정

필수 조건

  • Node.js(v16 이상)

  • npm 또는 yarn

  • Ethereum RPC 공급자(공개 또는 비공개)에 대한 액세스

설치

  1. 저장소를 복제하거나 새 프로젝트를 만듭니다.

지엑스피1

  1. 종속성 설치:

npm i
  1. Ethereum 공급자 구성: 다음 내용을 포함하여 프로젝트 루트에 .env 파일을 만듭니다(선택 사항):

PROVIDER_URL=https://your-provider-url.com,https://your-backup-provider.com

공급자가 지정되지 않으면 서버는 다음 기본값을 사용합니다.

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

npx 사용하기

{
  "mcpServers": {
    "ens": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-ens"
      ],
      "env": {
        "PROVIDER_URL": "https://your-provider-url.com,https://your-backup-provider.com"
      }
    }
  }
}

로컬 스크립트 사용

{
  "mcpServers": {
    "ens": {
      "command": "node",
      "args": [
        "/path/to/your/server.js"
      ],
      "env": {
        "PROVIDER_URL": "https://your-provider-url.com,https://your-backup-provider.com"
      }
    }
  }
}

오류 처리

서버는 다양한 시나리오에 대해 강력한 오류 처리를 구현합니다.

  • Ethereum 공급자에 연결하는 동안 네트워크 오류가 발생했습니다.

  • 잘못된 ENS 이름 또는 Ethereum 주소

  • ENS 관련 오류

  • 일반적인 운영 오류

모든 오류는 디버깅을 위한 기술적 세부 정보를 보존하면서 사용자 친화적인 메시지로 정규화됩니다.

출판

npm 패키지로 게시하려면:

npm publish --access public

문제 해결

오류가 발생하는 경우:

  • Ethereum 공급자가 작동하고 액세스 가능한지 확인하세요.

  • 쿼리하는 ENS 이름이 올바르게 형식화되어 있는지 확인하세요.

  • ENS 라이브러리의 최신 버전이 있는지 확인하세요.

  • PROVIDER_URL 환경 변수에서 여러 공급자를 쉼표로 구분하여 사용해 보세요.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Available Tools

8 tools
check-availabilityA

Check if an ENS name is available for registration

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesThe ENS name to check (without .eth suffix)

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden but only states the basic purpose. It doesn't disclose behavioral traits like whether this is a read-only operation (implied but not stated), rate limits, authentication requirements, network dependencies, or what happens with invalid names. The description is minimal and lacks operational context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's purpose with zero wasted words. It is appropriately sized for a simple query tool and front-loads the core functionality without unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple single-parameter query tool with no annotations and no output schema, the description is adequate but minimal. It covers the basic purpose but lacks context about return values (e.g., boolean availability status, error responses) or integration with sibling tools like 'get-registration-price'. Given the low complexity, it meets minimum viability.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with the parameter 'name' clearly documented in the schema. The description adds no additional parameter semantics beyond what the schema provides (e.g., no examples, format clarifications, or edge cases). Baseline 3 is appropriate when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('Check if... is available') and resource ('an ENS name'), with the verb 'check' precisely indicating a query operation. It distinguishes from siblings like 'get-registration-price' (price calculation) and 'resolve-name' (address lookup) by focusing on availability status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when determining if an ENS name can be registered, but provides no explicit guidance on when to use this tool versus alternatives like 'get-registration-price' (which might be a logical next step) or 'resolve-name' (for existing names). No exclusions or prerequisites are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get-all-recordsB

Get all available information for an ENS name

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesThe ENS name to query

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool retrieves information (implying a read-only operation) but doesn't specify aspects like rate limits, authentication needs, error conditions, or what 'all available information' entails (e.g., format, depth). This leaves significant gaps for safe and effective use.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, direct sentence with zero wasted words, front-loading the core purpose ('Get all available information for an ENS name'). It efficiently communicates the essential action and target without redundancy or fluff, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (one parameter, read-only implied), no annotations, and no output schema, the description is minimally adequate but incomplete. It clarifies the purpose and parameter broadly but omits behavioral details and output expectations, which could hinder an agent's ability to use it correctly in complex scenarios.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the single parameter 'name' clearly documented as 'The ENS name to query'. The description adds no additional parameter details beyond this, such as format examples or constraints, but the schema adequately covers the basics, meeting the baseline for high coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get all available information') and target resource ('for an ENS name'), making the purpose immediately understandable. It doesn't explicitly distinguish from siblings like 'get-text-record' or 'resolve-name', which might retrieve specific subsets of information rather than 'all available' data, but the scope is well-defined.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'get-text-record' or 'resolve-name' from the sibling list. It implies usage for comprehensive ENS name data but lacks explicit comparisons, prerequisites, or exclusions, leaving the agent to infer context from tool names alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get-name-historyC

Get the history of an ENS name

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesThe ENS name to check history for

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool retrieves history but doesn't specify what 'history' entails (e.g., ownership changes, transaction logs, registration events), whether it requires authentication, rate limits, or the format of the returned data. This leaves significant gaps for an agent to understand the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no wasted words. It is front-loaded with the core purpose, making it easy to parse quickly. Every part of the sentence contributes directly to understanding the tool's function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of historical data retrieval and the lack of annotations and output schema, the description is insufficient. It doesn't explain what type of history is returned, potential errors, or how to interpret results. For a tool that likely involves nuanced data, more context is needed to guide an agent effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the parameter 'name' clearly documented as 'The ENS name to check history for'. The description adds no additional meaning beyond this, as it doesn't elaborate on the format of the ENS name or provide examples. Given the high schema coverage, a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get the history') and the resource ('of an ENS name'), making the purpose immediately understandable. However, it doesn't differentiate this tool from its siblings like 'get-all-records' or 'resolve-name', which might also involve historical or record-related queries about ENS names.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With siblings like 'get-all-records' and 'resolve-name', there's no indication of whether this tool is for transaction history, ownership changes, or other types of historical data, leaving the agent to guess based on the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get-registration-priceC

Get the price to register an ENS name

ParametersJSON Schema
NameRequiredDescriptionDefault
durationNoRegistration duration in years
nameYesThe ENS name to check price for (without .eth suffix)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states what the tool does but lacks critical behavioral details: it doesn't specify if this is a read-only operation (implied but not stated), whether it requires authentication, rate limits, network calls, or what the output format looks like (e.g., currency, units). For a tool with zero annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's purpose without any fluff. It's front-loaded with the core action and resource, making it easy to parse. Every word earns its place, achieving optimal conciseness for this simple tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's moderate complexity (price calculation for registrations), lack of annotations, and no output schema, the description is incomplete. It doesn't cover behavioral aspects (e.g., read-only nature, potential errors), output details (e.g., price format), or usage context (e.g., when to call it relative to availability checks). For a tool with no structured safety or output information, more descriptive context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with both parameters ('name' and 'duration') well-documented in the schema. The description adds no additional parameter semantics beyond what the schema provides (e.g., it doesn't explain format constraints like name length or validation rules). Baseline 3 is appropriate when the schema does the heavy lifting, but no extra value is added.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get the price') and resource ('to register an ENS name'), making the purpose immediately understandable. It distinguishes from siblings like 'check-availability' (which checks name availability) or 'resolve-name' (which resolves addresses). However, it doesn't explicitly differentiate from all siblings (e.g., 'get-all-records' might also involve pricing data), keeping it at 4 rather than 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., name must be available), exclusions (e.g., invalid names), or relationships with siblings like 'check-availability' (which might be a prerequisite). Usage is implied but not explicitly stated, resulting in minimal guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get-subdomainsC

Get subdomains for an ENS name

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesThe ENS name to query for subdomains

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states what the tool does but doesn't describe how it behaves: no information on rate limits, authentication needs, error conditions, or what format the subdomains are returned in. For a query tool with zero annotation coverage, this leaves significant gaps in understanding the tool's operational characteristics.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that states exactly what the tool does with zero wasted words. It's appropriately sized for a simple query tool and front-loads the core functionality immediately.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete for effective tool use. It doesn't explain what format the subdomains are returned in, whether there are pagination considerations, or what happens with invalid ENS names. For a query tool with no structured output documentation, the description should provide more context about the return values and error conditions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the single parameter 'name' clearly documented as 'The ENS name to query for subdomains'. The description adds no additional parameter semantics beyond what's already in the schema. This meets the baseline of 3 when the schema does the heavy lifting, but earns no extra credit for enhancement.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get' and resource 'subdomains for an ENS name', making the purpose immediately understandable. It distinguishes this from siblings like 'get-all-records' or 'resolve-name' by focusing specifically on subdomains. However, it doesn't specify whether this returns direct subdomains only or includes nested ones, which prevents a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'get-all-records' (which might include subdomain data) or 'resolve-name' (which resolves names to addresses). There's no mention of prerequisites, context, or exclusions, leaving the agent to infer usage from the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get-text-recordC

Get a text record for an ENS name

ParametersJSON Schema
NameRequiredDescriptionDefault
keyYesThe record key to look up (e.g., 'email', 'url', 'avatar', 'description', 'twitter', etc.)
nameYesThe ENS name to query

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states the tool 'gets' a text record, implying a read-only operation, but doesn't specify whether it requires authentication, has rate limits, returns errors for non-existent records, or provides any context about the ENS system. This leaves significant gaps for an agent to understand the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's purpose without unnecessary words. It's appropriately sized and front-loaded, making it easy to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete. It doesn't explain what a 'text record' entails in the ENS context, what format the return value might have, or any error conditions. For a tool interacting with a specialized system like ENS, more context is needed for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, clearly documenting both required parameters ('name' and 'key') with examples for 'key'. The description adds no additional parameter semantics beyond what the schema provides, so it meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and resource ('text record for an ENS name'), making the purpose immediately understandable. However, it doesn't differentiate this tool from sibling tools like 'get-all-records' or 'resolve-name', which might also retrieve ENS-related data.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'get-all-records' (which might retrieve multiple records) or 'resolve-name' (which might resolve to an address). There's no mention of specific use cases, prerequisites, or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

resolve-nameB

Resolve an ENS name to an Ethereum address

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesThe ENS name to resolve (e.g., 'vitalik.eth')

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states the basic operation but omits critical details such as error handling (e.g., for invalid names), rate limits, authentication requirements, or response format. For a tool with zero annotation coverage, this leaves significant gaps in understanding its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's purpose with zero wasted words. It is front-loaded and appropriately sized for a simple tool, making it easy to parse and understand quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete. It covers the basic purpose but fails to address behavioral aspects like error cases or response structure, which are essential for a tool performing a resolution operation. This leaves the agent with insufficient context for reliable use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the parameter 'name' fully documented in the schema (including an example). The description adds no additional parameter semantics beyond what the schema provides, so it meets the baseline score of 3 for adequate but not enhanced parameter information.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('resolve') and target resource ('ENS name to an Ethereum address'), distinguishing it from siblings like 'reverse-lookup' (which does the opposite) or 'get-name-history' (which provides historical data). It precisely communicates the tool's function without ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for converting ENS names to addresses but provides no explicit guidance on when to use this tool versus alternatives like 'reverse-lookup' (for address-to-name resolution) or 'check-availability' (for name status). It lacks context on prerequisites or exclusions, leaving usage decisions to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

reverse-lookupB

Get the ENS name for an Ethereum address

ParametersJSON Schema
NameRequiredDescriptionDefault
addressYesThe Ethereum address to look up

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden but offers minimal behavioral insight. It doesn't disclose whether this is a read-only operation, if it requires authentication, rate limits, error conditions (e.g., unregistered addresses), or what happens on failure. The description is functional but lacks critical operational details.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that directly states the tool's purpose without unnecessary words. It's front-loaded with the core functionality and appropriately sized for a simple lookup operation. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple lookup tool with one parameter and no output schema, the description is minimally adequate. However, without annotations or output information, it doesn't address what the tool returns (e.g., ENS name string, null for unregistered addresses) or error behavior. The description covers the basic 'what' but misses important contextual details.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with the single parameter 'address' clearly documented in the schema. The description adds no additional semantic context beyond implying the parameter's purpose. This meets the baseline for high schema coverage, but doesn't enhance understanding of parameter usage or constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('Get') and target resource ('ENS name for an Ethereum address'), distinguishing it from sibling tools like 'resolve-name' (which likely does the opposite) or 'get-name-history' (which provides historical data). It precisely communicates the tool's function without ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., address format), exclusions (e.g., invalid addresses), or comparisons to siblings like 'resolve-name' (which might convert ENS names to addresses). Usage context is implied but not explicitly stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 8 tool updatesv1.0.0
    • First observedcheck-availability
    • First observedget-all-records
    • First observedget-name-history
    • First observedget-registration-price
    • First observedget-subdomains
    • First observedget-text-record
    • First observedresolve-name
    • First observedreverse-lookup

TDQS

B3.4/5.0

Scored across 8 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap: availability checks, retrieving records/history/price/subdomains/text, resolving names, and reverse lookups. The descriptions make it easy to differentiate between tools like 'get-all-records' (comprehensive info) and 'get-text-record' (specific record type).

Naming Consistency4/5

The naming follows a consistent verb-object pattern with hyphens (e.g., 'check-availability', 'get-all-records'), except for 'reverse-lookup' which uses a different verb style. This minor deviation slightly reduces consistency, but the overall pattern remains highly readable and predictable.

Tool Count5/5

With 8 tools, the count is well-scoped for an ENS server, covering key operations like checking availability, retrieving various data types, resolving addresses, and reverse lookups. Each tool earns its place without feeling excessive or insufficient for the domain.

Completeness4/5

The toolset provides strong coverage for querying and resolving ENS names, including availability, records, history, price, subdomains, text records, and bidirectional resolution. A minor gap is the lack of write operations (e.g., registering or updating names), but the read-focused surface is nearly complete for its apparent purpose.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers