EVE Online ESI MCP Server
The EVE Online ESI MCP Server provides comprehensive, performance-optimized access to EVE Online's ESI API with MCP-remote compatibility, offering:
Complete API Integration: Access 400+ auto-generated tools from the official ESI swagger specification, covering character, corporation, alliance, market, and universe data with real-time updates.
Enterprise Performance: Features intelligent ETag-based caching, ML-driven optimization, and advanced rate limiting, delivering 50-70% faster response times.
MCP-Remote Compatibility: Seamlessly integrates with MCP clients like Claude Desktop, Cursor, and Windsurf using multiple transport strategies.
Authentication & Security: Implements EVE SSO OAuth 2.0 with PKCE, dynamic client registration, and token management for 67 ESI scopes.
Rich Functionality: Retrieve character information, assets, skills, corporation data, market prices, universe details, and resolve names to IDs, with advanced filtering options.
Monitoring & Management: Includes health checks, performance metrics, cache statistics, and configuration examples for easy server management.
Enables configuration of the EVE Online ESI MCP server through environment variables, including API keys, OAuth settings, and server port options.
Provides installation and package management for the EVE Online ESI MCP server, including automated installation via Smithery.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@EVE Online ESI MCP Serverget my character's current location and ship"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
EVE Online ESI MCP Server
The most comprehensive and performance-optimized EVE Online ESI MCP server available. This enterprise-grade server provides complete access to EVE Online's ESI API through the Model Context Protocol, with advanced performance optimization, full mcp-remote compatibility, and automatic API coverage.
🚀 Key Features
Complete ESI Integration
400+ Auto-Generated Tools: Complete API coverage from official ESI swagger specification
Real-time Updates: Tools automatically generated from latest ESI specification
Official ESI Compliance: Implements all CCP Games best practices and rate limiting
Smart Categorization: Tools organized by character, corporation, alliance, market, universe, etc.
Enterprise Performance
Intelligent Caching: ETag-based caching with ESI expires header compliance
ML-Driven Optimization: Predictive resource allocation and performance learning
Advanced Rate Limiting: ESI error-based limiting + endpoint-specific controls
Connection Pooling: HTTP keep-alive and connection reuse optimization
50-70% Performance Improvement: Measured response time enhancements
MCP-Remote Optimized
Full geelen/mcp-remote Support: Seamless integration with Claude Desktop, Cursor, Windsurf
Multiple Transport Strategies: SSE-first, HTTP-only, auto-detection
CORS Optimization: Pre-configured for all major MCP clients
OAuth Integration: Complete EVE SSO authentication flow
Authentication & Security
EVE SSO OAuth 2.0: Full PKCE implementation with 67 available scopes
Dynamic Client Registration: Automatic OAuth client setup
Token Management: Refresh, verify, and exchange capabilities
Security Best Practices: Rate limiting, input validation, secure headers
Related MCP server: MCP Server
Installation
Installing via Smithery
To install EVE Online ESI Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @kongyo2/eveonlineesi-mcp --client claudeManual Installation
npm installConfiguration
Create a .env file with the following variables:
# EVE Online ESI API Key (for ESI authentication)
EVE_ONLINE_APIS_API_KEY=your_eve_api_key
# OAuth Configuration (optional - will use defaults if not provided)
OAUTH_CLIENT_ID=eve-online-esi-mcp
OAUTH_CLIENT_SECRET=your_oauth_secret
JWT_SECRET=your_jwt_secret
# Server Port (default: 3001)
PORT=3001Running the Server
Local Mode (stdio)
For direct local connections:
npm startRemote Mode (SSE/HTTP)
For remote connections with OAuth:
npm run start:sse🎯 MCP-Remote Integration
Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"eve-online-esi": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:3001/sse"]
}
}
}Cursor Configuration
{
"mcpServers": {
"eve-online-esi": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:3001/sse",
"--transport",
"sse-first"
]
}
}
}Windsurf Configuration
{
"mcpServers": {
"eve-online-esi": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:3001/sse", "--allow-http"]
}
}
}Advanced Transport Strategies
# SSE-first (recommended): Try SSE, fallback to HTTP
npx mcp-remote http://localhost:3001/sse --transport sse-first
# SSE-only: Use only Server-Sent Events
npx mcp-remote http://localhost:3001/sse --transport sse-only
# HTTP-only: Use only HTTP requests
npx mcp-remote http://localhost:3001/mcp --transport http-only
# With custom headers
npx mcp-remote http://localhost:3001/sse --header "x-api-key: your-key"Get Configuration Examples
curl http://localhost:3001/mcp-config🛠 Available Tools (400+)
Auto-Generated from ESI Swagger Specification
Character Tools (150+ tools, authentication required)
get_characters_character_id- Character informationget_characters_character_id_assets- Character assets and locationsget_characters_character_id_location- Current character locationget_characters_character_id_online- Online statusget_characters_character_id_ship- Current ship informationget_characters_character_id_wallet- Wallet balance and transactionsget_characters_character_id_mail- Mail headers and messagesget_characters_character_id_skills- Character skills and skill queueget_characters_character_id_clones- Clone informationget_characters_character_id_implants- Active implantsAnd 140+ more character endpoints...
Corporation Tools (50+ tools)
get_corporations_corporation_id- Corporation informationget_corporations_corporation_id_members- Corporation membersget_corporations_corporation_id_assets- Corporation assetsget_corporations_corporation_id_wallets- Corporation walletsget_corporations_corporation_id_structures- Corporation structuresAnd 45+ more corporation endpoints...
Alliance Tools (10+ tools)
get_alliances- List all active alliancesget_alliances_alliance_id- Alliance informationget_alliances_alliance_id_corporations- Alliance corporationsget_alliances_alliance_id_icons- Alliance iconsAnd more alliance endpoints...
Market Tools (20+ tools)
get_markets_region_id_orders- Market orders by regionget_markets_region_id_history- Historical market dataget_markets_prices- Global market pricesget_markets_groups- Market groups and categoriesAnd more market endpoints...
Universe Tools (200+ tools)
get_universe_regions- All regionsget_universe_systems- All solar systemsget_universe_stations- All stationsget_universe_structures- Public structuresget_universe_types- All item typesget_universe_categories- Item categoriesAnd 194+ more universe endpoints...
Industry Tools (30+ tools)
Manufacturing, research, and blueprints
Industry jobs and facilities
Mining operations and extractions
Other Categories (80+ tools)
Mail System: Character and corporation mail
Calendar: Events and scheduling
Contracts: Contract management
Fittings: Ship fittings and loadouts
Killmails: Combat records
Loyalty Points: LP stores and offers
Planetary Interaction: PI operations
Search: Universal search functionality
Wars: War declarations and status
Enhanced Performance Tools
get_performance_dashboard- Comprehensive server metricsget_tool_recommendations- AI-powered optimization suggestionsget_esi_scopes- Available authentication scopesgenerate_eve_auth_url- EVE SSO authorization URLs
OAuth Flow
When connecting via mcp-remote, you'll be redirected to authorize
Approve access to grant permissions
The server will issue an access token
All subsequent requests will use this token
Transport Strategies
When using mcp-remote, you can specify transport strategies:
# SSE only
npx mcp-remote http://localhost:3001/sse --transport sse-only
# HTTP only
npx mcp-remote http://localhost:3001/mcp --transport http-only
# Try SSE first, fallback to HTTP
npx mcp-remote http://localhost:3001/sse --transport sse-first🌐 API Endpoints
MCP Transport
SSE:
GET /sse- Server-Sent Events transport (mcp-remote optimized)HTTP:
POST /mcp- HTTP transport for single requestsTransport Detection:
GET /transport- Capability detection for mcp-remote
Authentication
OAuth Registration:
POST /oauth/register- Dynamic client registrationOAuth Authorization:
GET /oauth/authorize- OAuth flow initiationOAuth Token:
POST /oauth/token- Token exchange
EVE SSO Integration
EVE Auth:
GET /auth/eve- Generate EVE SSO authorization URLEVE Callback:
POST /auth/eve/callback- Exchange authorization codeEVE Refresh:
POST /auth/eve/refresh- Refresh access tokensEVE Verify:
POST /auth/eve/verify- Verify token validity
Monitoring & Management
Health Check:
GET /health- Enhanced health statusPerformance Metrics:
GET /metrics- Comprehensive performance dataCache Stats:
GET /cache/stats- Cache performance metricsCache Clear:
DELETE /cache- Clear cache (authenticated)MCP Config:
GET /mcp-config- Client configuration examples
Development
To list all available tools:
npm run list-toolsSecurity
OAuth tokens expire after 1 hour
PKCE is supported for enhanced security
All API requests require valid authentication
Client secrets are stored securely
📚 Documentation
ESI Integration Guide - Complete ESI implementation details
MCP-Remote Guide - Full mcp-remote integration guide
Performance Guide - Performance optimization and monitoring
📊 Performance Statistics
Total Tools: 400+ auto-generated from ESI specification
Response Time: 50-70% improvement with intelligent caching
Cache Hit Rate: 80-90% efficiency
API Coverage: 100% of public ESI endpoints
Authentication: 67 ESI scopes supported
Transport Options: SSE, HTTP, auto-detection
🛡 Security & Compliance
ESI Best Practices: Full compliance with CCP Games recommendations
Error-based Rate Limiting: Prevents API abuse and bans
PKCE Support: Enhanced OAuth security
Token Management: Secure refresh and validation
Input Validation: Comprehensive parameter validation
🔧 Development
Running Tests
npm run list-toolsDocker Support
npm run docker:build
npm run docker:runEnvironment Variables
See .env file for all configuration options including performance tuning, authentication, and ESI settings.
🤝 Contributing
This server implements the complete EVE Online ESI specification with enterprise-grade performance and mcp-remote optimization. Contributions are welcome for additional features or optimizations.
📄 License
MIT
Built with ❤️ for the EVE Online community. Optimized for Claude Desktop, Cursor, Windsurf, and all MCP clients.
Available Tools
37 toolsalliance_corporationsB
Retrieve all corporations in a specified alliance.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the alliance to retrieve corporations for. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, and description fails to disclose behavioral traits such as the format of the returned data (e.g., IDs vs full objects), potential pagination, or authorization needs. The tool could be a read operation, but this is not stated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence with no wasted words. It is front-loaded with the action and resource, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple tool with one parameter and no output schema, the description is minimal. It explains the basic purpose but omits details about the return format (e.g., is it a list of IDs or full objects?) and any limitations.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single parameter, so baseline is 3. Description does not add any additional meaning beyond the schema's description of the parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states verb 'Retrieve', resource 'corporations', and scope 'in a specified alliance'. It distinguishes from sibling tools like 'get_corporation' (single corp) and 'character_*' (character-specific).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. For example, it doesn't mention that this returns a list, while 'get_corporation' returns a single entity. No when-not-to-use conditions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_blueprintsB
Retrieve blueprints owned by a character in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character whose blueprints are to be retrieved. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. Only states basic retrieval without disclosing side effects, permissions required, rate limits, or output format. Lacks behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence of 9 words, front-loaded with key information. While minimal, it is efficient and to the point.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple retrieval tool with one parameter and no annotations, description is too brief. Lacks details about output, pagination, errors, or any additional context that would help an agent use it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% and the schema describes the 'id' parameter. Description does not add extra meaning beyond the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clearly states the action (retrieve) and resource (blueprints owned by a character). Distinct from sibling tools which cover other character data like bookmarks, mail, location, etc.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs alternatives. Does not mention any prerequisites or when not to use it. Sibling tools are listed but not referenced.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_bookmarksB
Retrieve character bookmarks from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character whose bookmarks are to be retrieved. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Lacking annotations, the description provides no behavioral details such as whether this is a read-only operation, authentication requirements, or rate limits. It simply states 'retrieve' without elaboration.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence with no wasted words, efficiently conveying the core function.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple retrieval tool with one parameter, the description covers the basic purpose. However, it lacks details about the return format or any other contextual information that would aid an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a clear description for the single parameter 'id'. The description adds no additional meaning beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states it retrieves character bookmarks from the EVE Online API, with a clear verb and resource. However, it does not explicitly differentiate from the sibling 'character_bookmarks_folders', though the resource names differ.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like 'character_bookmarks_folders' or other character-related tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_bookmarks_foldersA
Retrieve a list of character’s personal bookmark folders.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character whose bookmark folders are being requested. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description only indicates a read operation ('retrieve'). It misses important behavioral info like authentication, rate limits, or pagination.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that is front-loaded and contains no extraneous content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter retrieval tool, the description covers the basic purpose but lacks details on output structure, error handling, or usage constraints. Adequate but not comprehensive.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a clear description for the 'id' parameter. The tool description adds context ('personal bookmark folders') but does not significantly enhance the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool retrieves a list of character's personal bookmark folders. It differentiates from sibling 'character_bookmarks' by specifying 'folders'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies use for bookmark folders but lacks explicit guidance on when to use vs alternatives, prerequisites, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_locationB
Get the current location of a character in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The character ID for which to retrieve the location. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided. Description does not disclose authentication needs, rate limits, offline behavior, or what 'location' means precisely. Minimal behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no redundancy, front-loaded. Every word serves a purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema, no annotations. Description fails to explain return format or behavior for offline characters. Incomplete for a simple tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers the single parameter fully (100% coverage). Description adds no additional meaning beyond the schema's param description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it retrieves the current location of a character, with specific verb and resource. Distinct from sibling tools like character_online or character_ship.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like character_ship or character_online. Lacks context for selection among many character-related tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_mail_listC
Retrieve a character's mail list from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character whose mail list is to be retrieved. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description must cover behavioral traits. It only states 'Retrieve,' implying a read operation, but lacks details on pagination, authentication, rate limits, or what the output contains.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence that is front-loaded with the action and resource. It is concise but could add slightly more specificity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple tool with one parameter and no output schema, the description covers the basic purpose but omits behavioral context like pagination or format, which is needed since annotations are absent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% for the single parameter 'id.' The description adds no extra meaning beyond the schema's own description, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Retrieve' and the resource 'character's mail list' from the EVE Online API, distinguishing it from sibling 'character_mail_message' which likely handles individual messages.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use or not use this tool. It does not mention prerequisites, context, or alternatives, leaving the agent to infer usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_mail_messageB
Retrieve a character’s mail messages from EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character whose mail messages are to be retrieved. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description bears full burden. It accurately indicates a read operation ('retrieve') but omits important behavioral details such as whether the response is paginated, what fields are returned, or any authentication requirements. It is minimally transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence with no redundant information. It is front-loaded and every word serves a purpose. Perfectly efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema and no annotations, the description does not explain the return value structure or any limits. It is adequate for a simple retrieval but lacks completeness about what the agent should expect.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema already fully describes the sole parameter 'id' as 'The ID of the character whose mail messages are to be retrieved.' The description adds no further meaning; schema coverage is 100%, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action 'Retrieve' and the resource 'a character’s mail messages', distinguishing it from related tools like character_mail_list. However, it ambiguously uses plural 'messages' while the single 'id' parameter suggests a single message, which could confuse slightly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 over siblings. For example, it doesn't explain that this is for retrieving the content of messages, while character_mail_list might be for listing metadata. No when-not or alternative mentions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_onlineB
Check if a character is currently online in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character to check. |
TDQS
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 it checks if a character is online, which implies a read operation, but gives no details about authentication requirements, rate limits, error handling, or what the output looks like (e.g., boolean, string). The lack of output schema makes this gap more significant.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no wasted words. It is front-loaded and directly communicates the core function.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple tool with one parameter and no output schema, the description is incomplete. It does not specify the return format or behavior in edge cases (e.g., character not found). An agent would need to infer or experiment to understand the response.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a clear parameter description for 'id.' The tool description adds no extra meaning beyond what the schema already provides, meeting the baseline expectation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Check if a character is currently online.' It uses a specific verb and resource, and the sibling tools list includes many character-related tools (e.g., character_location, character_ship) that are distinct, so there is no confusion about what this tool does.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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, such as other character status tools or non-character tools. No exclusions or context are given, leaving the agent to infer usage from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_shipA
Get the current ship type, name, and id for a character in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character to retrieve the ship information for. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description carries the burden. It correctly indicates a read operation ('get'), but lacks details on side effects, authorization needs, or rate limits. Adequate but not rich.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no redundant words, front-loaded with the action and result. Highly concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter tool with no output schema, the description sufficiently explains what is retrieved and for whom. Could mention output structure, but not essential.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema has 100% description coverage for the single parameter. The description adds context ('for a character') but does not provide extra information beyond the schema. Baseline score applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Get' and the resources 'current ship type, name, and id for a character', which is specific and distinguishes it from sibling tools like character_location or character_online.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives, or prerequisites (e.g., authentication). Usage is implied but not clarified.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_titlesB
Retrieve a character's titles from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character whose titles are to be retrieved. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description only says 'Retrieve' which implies a read operation. It does not disclose any behavioral traits such as authentication requirements, rate limits, or error handling.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is concise and front-loaded. It could potentially include more detail without becoming verbose, but it is appropriately sized for its simplicity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description lacks information about the return value, error conditions, and any prerequisites. Given the absence of an output schema and annotations, more context is needed for an agent to fully understand usage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents the parameter. The tool description does not add any further meaning beyond what the schema provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (Retrieve) and the resource (a character's titles). It distinguishes from sibling tools like character_blueprints or character_location by specifying a unique resource type.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool vs. alternatives. The description simply states what it does without any contextual cues for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
character_walletB
Retrieve a character's wallet balance from EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character whose wallet balance is to be retrieved. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose behavioral traits. It only says 'Retrieve', implying a read operation, but provides no detail on authentication needs, error handling, or result format.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that immediately conveys the tool's function. No filler or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no output schema and no annotations, the description is too minimal. It lacks context on authentication, output format (e.g., balance in ISK), and error scenarios.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single parameter 'id'. The description does not add extra meaning beyond the schema's own parameter description. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Retrieve' and the resource 'wallet balance'. It uniquely identifies the tool among siblings, as no other sibling tool deals with wallet balances.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No usage guidance is provided. The description does not specify when to use this tool vs alternatives, nor does it mention any prerequisites or limitations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_allianceB
Retrieve information about an alliance in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the alliance to retrieve information for. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must cover behavioral traits. It correctly indicates a read-only operation via 'Retrieve', but lacks details on authentication, rate limits, or error conditions. This is adequate for a simple retrieval but leaves gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, well-structured sentence with no wasted words. It is front-loaded and efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite the tool's simplicity, the description lacks information about the output format or field expectations (no output schema). The agent cannot know what 'information' includes, which reduces completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% for the single parameter 'id', which is described as 'The ID of the alliance to retrieve information for.' The description adds no extra semantic value beyond the schema, so 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.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Retrieve' and resource 'information about an alliance' in the domain of EVE Online. It effectively distinguishes the tool from siblings like get_corporation and get_factions by focusing on alliances.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool over alternatives, nor any prerequisites or context. The description does not address exclusions or provide any usage hints.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_attributesC
Retrieve attributes from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must carry the full burden of behavioral disclosure. It only states the action without mentioning safety, error handling, rate limits, or any side effects, leaving the agent uninformed about potential impacts.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single sentence is concise but overly brief, lacking critical detail that could be included without significant length. Front-loading is fine, but the content is insufficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the absence of parameters, output schema, and annotations, the description fails to provide essential context about what the tool returns, its scope, or how it relates to the many attribute-related sibling tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has no parameters, so the baseline is 4. The description does not add parameter-specific meaning beyond the schema, but no parameters exist, so it is acceptable.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Retrieve attributes from the EVE Online API,' which identifies the general action and resource, but fails to specify what kind of attributes (e.g., character, dogma, universe) and does not distinguish it from sibling tools like get_dogma_attribute or character_titles.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus its siblings. The description lacks any context about scenarios or alternatives, leaving the agent to guess the tool's role.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_character_infoC
Retrieve information about a specific character in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the character to retrieve information for. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden. It only states 'Retrieve information' without disclosing read-only behavior, authentication needs, rate limits, or error handling (e.g., if the character ID is invalid). This leaves significant gaps for the agent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence of 8 words, which is appropriate for a simple tool. It is front-loaded and contains no unnecessary text, but could benefit from structure (e.g., bullet points for return data).
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of output schema, the description should at least hint at the kind of information returned (e.g., character name, corporation, age). It does not, leaving the agent uncertain about the tool's output. This is a significant gap for completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single parameter 'id', with a description that mirrors the schema. The tool description adds no extra semantic value beyond what is already in the schema, so a baseline of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses the verb 'Retrieve' and specifies the resource 'information about a specific character', which clearly indicates the tool's basic function. However, it lacks specificity on what type of information is returned, making it less distinguishable from sibling tools like character_blueprints or character_location.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 such as character_online or character_ship. Without context, an agent may not know that this tool retrieves general character info, while sibling tools cover specific aspects.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_corporationB
Retrieve information about a specific corporation in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the corporation to retrieve information for. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It only says 'Retrieve information' without specifics on behavior such as auth requirements, rate limits, or what fields are returned. Minimal transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One short, front-loaded sentence with no waste. Efficiently conveys the core purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema and no annotations, the description is too minimal: it doesn't explain what 'information' includes or any constraints. Moderately incomplete for a tool with average complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% (one parameter 'id' fully described). The tool description adds no extra meaning beyond the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states 'Retrieve information about a specific corporation in EVE Online.' It uses a specific verb ('retrieve') and resource ('information about a specific corporation'), clearly distinguishing it from sibling tools like get_alliance or get_character_info.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool vs alternatives. Usage is implied (by ID), but no context for when not to use or what alternatives exist among siblings like get_corporation_alliance_history.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_corporation_alliance_historyB
Retrieve the alliance history of a corporation.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the corporation whose alliance history is to be retrieved. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose behavioral traits. It only states 'retrieve', implying read-only, but lacks details on rate limits, permissions, error handling, or response format. This is minimal transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence that directly states the tool's purpose with no wasted words. It is appropriately front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple retrieval tool with no output schema, the description is adequate but could be improved by mentioning the expected return type (e.g., list of alliance entries with dates). It is complete enough for basic understanding but lacks full context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% for the single parameter 'id', so baseline is 3. The description adds no additional meaning beyond the schema's description, thus no extra value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Retrieve the alliance history of a corporation' clearly states the verb (retrieve), resource (alliance history), and scope (corporation). It distinguishes this tool from siblings like 'get_corporation' and 'alliance_corporations' which serve different purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives. The description implies usage when needing alliance history but provides no context about prerequisites or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_dogma_attributeC
Retrieve a dogma attribute from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
| dogmaAttributeId | No | The ID of the dogma attribute to retrieve. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description must fully disclose behavior. It only states 'retrieve', providing no details about side effects, authentication requirements, rate limits, or whether it is a read-only operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no wasted words, achieving good conciseness. However, it foregoes important details in favor of brevity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the absence of an output schema and annotations, the description is too minimal. It doesn't explain what a dogma attribute is, the kind of data returned, or any usage constraints, leaving the agent with insufficient context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, and the schema already describes the single parameter. The description adds no additional meaning beyond what is in the schema, so the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The verb 'Retrieve' and resource 'dogma attribute' clearly indicate the tool's action and target. However, the description does not differentiate it from the similar sibling tool 'get_attributes', which might retrieve multiple attributes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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, no exclusions, and no context such as prerequisites or preferred scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_effectC
Retrieve information about a specific effect in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| effectAttributeId | No | The ID of the effect attribute to retrieve. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description bears full responsibility for behavioral disclosure. It merely states 'Retrieve information' without addressing authentication, rate limits, error handling, or consequences of missing parameters.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence, efficient and front-loaded with the action. However, it could include key details like 'by ID' without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema and no annotations, the description fails to explain return value structure, error conditions, or any contextual details beyond the bare minimum. This is insufficient for a retrieval tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage for the single parameter (effectAttributeId). The tool description adds no extra meaning beyond the schema's description, so baseline 3 is appropriate. The optionality of the parameter is not clarified.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Retrieve' and the resource 'information about a specific effect in EVE Online'. It distinguishes from the sibling tool 'get_effects' (plural) by the singular reference, but does not explicitly differentiate itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No usage guidance is provided. There is no indication of when to use this tool versus alternatives like 'get_effects' for listing effects, or what to do if the effect attribute ID is not provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_effectsA
Retrieve effects from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description indicates a read operation, which is standard for retrieval. With no annotations, the description carries full burden, but it does not disclose behaviors like pagination, result format, or any side effects. It is minimal but sufficient for a simple, parameterless read.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, clear sentence with no unnecessary words. It is perfectly concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no parameters and no output schema, the description adequately conveys the tool's purpose. However, it could mention the return type (list of effects) or any limitations for completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are no parameters in the input schema (100% coverage). The description does not add parameter info, but none is needed. Baseline for 0 parameters is 4 per guidance.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Retrieve effects') and the target resource ('EVE Online API'). However, it does not differentiate from the sibling tool 'get_effect' (singular), which may return a single effect. This ambiguity limits purpose clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like 'get_effect' or other list retrieval tools. The agent is left to infer usage without explicit context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_factionsB
Retrieve factions from the EVE Online Universe.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. It only states 'retrieve' without mentioning data freshness, authentication needs, rate limits, or any side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence, front-loaded, and no unnecessary words. Ideal conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no parameters, no output schema, and multiple related sibling tools, the description is minimal. It does not explain what a faction is, how many exist, or whether pagination is needed. It is borderline adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are no parameters, so schema coverage is 100%. The description adds no parameter-level meaning beyond the empty schema, but this is adequate given zero parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool retrieves factions from the EVE Online Universe using a specific verb and resource. However, it does not differentiate from sibling tools like get_alliance or get_corporation which also retrieve entities.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool vs alternatives. The description implies usage through the name, but explicit context or exclusion criteria are missing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_group_infoC
Retrieve information about a specific group in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| group_id | Yes | The ID of the group to retrieve information for. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided and description does not disclose behavioral traits (e.g., read-only, idempotent); the minimal description fails to convey expected behavior beyond a basic retrieval.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no wasted words; though brief, it is appropriately sized for a simple tool, but could include more detail without being verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Lacks information about return format, usage context, or differentiation from similar tools; agent may be uncertain about expected output or appropriate use case.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema covers parameter description fully (100% coverage); description adds no extra meaning beyond the schema, thus baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clear verb 'Retrieve' and resource 'information about a specific group' but does not differentiate from sibling tools like 'get_universe_groups', leaving ambiguity about what constitutes a 'group' in EVE Online.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives; lacks context for decision-making.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_killmailC
Retrieve killmail information from EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the killmail. | |
| hash | Yes | The hash of the killmail. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, and the description only says 'retrieve', implying read-only, but does not disclose any behavioral traits such as rate limits, authentication needs, or side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One concise sentence, directly stating the purpose with no unnecessary information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description lacks details about what 'killmail information' includes, and no output schema is provided. For a retrieval tool with two required parameters, it is incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the description adds no extra meaning beyond what the schema provides. Breif but adequate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'retrieve' and resource 'killmail information' from 'EVE Online API', making it distinct from sibling tools. However, it could be more specific about the type of information.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance provided on when to use this tool vs alternatives. No prerequisites or context mentioned, despite many sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_market_groupB
Retrieve market group information from the EVE ESI API.
| Name | Required | Description | Default |
|---|---|---|---|
| groupId | Yes | The market group identifier. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must disclose behavioral traits. It only states the action without mentioning side effects, authorization, rate limits, or error conditions. Minimal transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is very concise (one sentence), but it sacrifices necessary information like usage context and behavior. It is not overly verbose, but it is under-informative.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is too minimal for a tool with no output schema and no annotations. It does not explain return format or data content, leaving gaps for the agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already documents the parameter fully (100% coverage). The description adds no additional meaning, so baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Retrieve' and the resource 'market group information'. It implicitly distinguishes from the sibling 'get_market_groups' (plural) by implying a single group retrieval.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like 'get_market_groups' or 'get_group_info'. The description lacks any context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_market_groupsC
Retrieve market groups from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, and the description does not disclose behavioral traits such as read-only nature, authentication requirements, or rate limits. For a tool with no annotations, the description should cover these but does not.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that states the core functionality concisely. It is not overly verbose, but it could be slightly more informative without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no parameters and no output schema, the description is minimally adequate. However, it leaves ambiguity about whether this returns a list or a single item, and lacks details about the output format.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are zero parameters, so the input schema is fully covered. The description adds no parameter detail, but none is needed. The baseline for 0 parameters is 4 per guidelines.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Retrieve market groups' which is clear as a verb-resource pair, but it does not differentiate from the sibling tool 'get_market_group' (singular). The lack of indication that this returns a list of all market groups rather than a single group reduces clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like 'get_market_group' or 'get_universe_groups'. The description fails to set context for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_region_historyC
Get market history for a specific region in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| typeId | No | The type ID of the item to get market history for. | |
| regionId | Yes | The ID of the region to fetch market history for. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description must disclose behavioral traits. It only states 'Get market history,' implying a read operation, but fails to mention pagination, rate limits, data freshness, or the format of returned data. This is insufficient for an agent to understand side effects or constraints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is concise and to the point. However, it does not front-load the most critical information about what exactly is returned or any constraints. It is well-structured but could benefit from slightly more detail without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of output schema and annotations, the description fails to provide enough context for correct usage. It does not explain the response structure, any required prerequisites (e.g., authentication), or how the data is scoped (e.g., time range). This is inadequate for a tool with two parameters and no other documentation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema description coverage, the baseline is 3. The description adds no additional meaning to the parameters beyond what is already in the input schema. It does not clarify how regionId relates to the history or provide any usage hints.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it retrieves market history for a specific region in EVE Online. However, it does not differentiate from sibling tools like get_region_info, market_prices, or region_orders, which are similarly named and could cause confusion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives such as market_prices or region_orders. The description lacks context about prerequisites or typical use cases.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_region_infoB
Retrieve information about a specific region in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the region to retrieve information about. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden but merely says 'retrieve', implying a read operation. No details about error handling, authentication, or data scope are given.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence, no redundancy, and front-loaded with the core purpose. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter retrieval tool with no output schema, the description is adequate but incomplete. It does not specify what information is returned (e.g., name, description, stats).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a single required integer ID. The description adds no additional meaning beyond what the schema already provides, meeting the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states 'retrieve information about a specific region' with a clear verb and resource. However, it does not differentiate from sibling tools like 'get_regions' or 'get_region_history', lacking sibling distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives, and no context provided about prerequisites or limitations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_regionsB
Retrieve a list of regions from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description implies a read-only operation by stating 'Retrieve', but it does not disclose any behavioral traits beyond that. Without annotations, the description could mention if the list is complete, paginated, or if there are rate limits. It provides minimal insight into 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence with no wasted words. It is front-loaded with the key verb and resource, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simplicity of the tool (no parameters, no output schema), the description is functional but lacks context. It does not explain what a 'region' is in EVE Online or if there are any limitations (e.g., only certain regions). It is minimally complete for its complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has no parameters, and schema description coverage is 100% (trivially). The description does not need to add parameter info. Per the guidelines, zero parameters sets a baseline of 4, and the description is adequate here.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states that the tool retrieves a list of regions from the EVE Online API. It uses a specific verb ('Retrieve') and resource ('list of regions'), making the purpose straightforward. However, it does not explicitly differentiate from sibling tools like 'get_region_info' or 'get_region_history', which could cause confusion about the scope.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus alternatives. With many sibling tools that also retrieve data, the description lacks context on when 'get_regions' is the appropriate choice, such as for getting all regions vs. a specific region.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_statusB
Get the status from the EVE ESI API.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description does not disclose any behavioral traits (e.g., read-only nature, potential side effects). The description carries the full burden for transparency but fails to convey anything beyond the basic action.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that directly states the tool's purpose without any extraneous information. It is appropriately sized for a simple tool with no parameters.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is adequate for a simple status check but lacks details about the output format or what the status contains. With no output schema, the description could be more complete, but it suffices for a minimal tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so schema coverage is 100%. The description adds the context of calling an external API (EVE ESI), which provides meaning beyond the empty schema, but no further parameter details are needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool retrieves a status from a specific API, but it does not specify what the status pertains to (e.g., server status, system status), leading to slight ambiguity. It is distinct from sibling tools, as none are specifically for status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. Since it has no parameters, usage is straightforward, but the description lacks any context about typical use cases or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_structureB
Retrieve information about a specific structure in EVE.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the structure to retrieve. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description bears full burden. It implies a read-only operation ('Retrieve information') but does not explicitly state safety, authentication needs, or any behavioral traits such as rate limits or return format.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single 8-word sentence with no redundancy. Perfectly concise and front-loaded for the tool's simplicity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple tool with no output schema, the description is minimally adequate but lacks detail on what returned 'information' includes, which could be ambiguous. The sibling 'get_structures' is plural but no further context is given.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema coverage, the schema already describes the 'id' parameter as 'The ID of the structure to retrieve.' The description adds no additional meaning or context about the ID format or source, meeting the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it retrieves information about a specific structure. The singular 'structure' effectively distinguishes it from the sibling 'get_structures' (plural), but does not elaborate on what 'information' includes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like 'get_structures' or other get_* tools. No prerequisites or context provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_structuresB
Retrieve structures from the EVE Online universe.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden for behavioral disclosure. It only says 'Retrieve structures' without mentioning whether it requires authentication, rate limits, data freshness, or the scope of structures returned (e.g., player-owned, orbital, all).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is front-loaded with the verb and resource. There is no extraneous information, making it very concise and easy to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no parameters, annotations, or output schema, the description is the sole source of context. It fails to specify what 'structures' refers to (e.g., all structures in the universe, only those visible to the character), leaving significant ambiguity. A more complete description would clarify the scope and return format.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters and the input schema coverage is 100% (empty). The description adds no parameter information, but baseline is 4 for zero-parameter tools. It does not need to elaborate further, though it could clarify that no filters are available.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (Retrieve) and resource (structures) from the EVE Online universe, distinguishing it from the singular 'get_structure' sibling. However, it could be more specific about whether it returns all structures or a filtered list, and 'EVE Online universe' is somewhat vague.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided about when to use this tool versus alternatives like 'get_structure' (singular) or other retrieval tools. There is no mention of prerequisites, context, or scenarios where this tool is appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_type_infoC
Get information about a specific type in the EVE Online universe.
| Name | Required | Description | Default |
|---|---|---|---|
| typeId | Yes | The type identifier for the universe type. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description carries full burden. It does not disclose any behavioral traits such as the structure of returned information, authentication needs, or potential errors.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is concise and front-loaded. It contains no unnecessary words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of output schema and annotations, the description is insufficient for the agent to understand what the tool returns or how to use the result.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% for the single parameter. The description adds no extra meaning beyond the schema, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it retrieves information about a specific type in EVE Online, using a verb and resource. However, among many sibling get_* tools, it does not differentiate what qualifies as a 'type' versus other entities.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool over alternatives like get_alliance or get_corporation. The description lacks context about what a 'type' represents.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_universe_groupsB
Retrieve universe groups from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description does not disclose any behavioral traits such as authentication requirements, rate limits, data freshness, or the nature of the return data. The agent is left with minimal insight beyond the basic purpose.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence, which is concise. However, it is not front-loaded with critical information; it simply states the action. For such a simple tool, this is acceptable but not exemplary.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no parameters, no output schema, and low complexity, the description is minimally complete. It states what the tool does, but lacks context about what a 'universe group' entails or any details about the response format. The agent has basic understanding.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are no parameters, so the schema coverage is 100%. Per calibration guidance, with 0 parameters the baseline is 4. The description does not need to add parameter details since there are none.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Retrieve') and the resource ('universe groups'). It distinguishes well from sibling tools like 'get_factions' or 'get_regions', which target different EVE Online data entities.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. There is no mention of use cases, prerequisites, or scenarios where another tool would be more appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_universe_namesB
Retrieve names from the EVE Online Universe API based on provided IDs.
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | An array of IDs to look up names for. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of disclosing behavior. It only states the action (retrieve names), but fails to mention that it is a read-only operation, potential rate limits, error handling, or output format. The minimal information offers low transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that efficiently conveys the core purpose without any wasted words. It is appropriately sized and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (single parameter, no output schema), the description is minimally adequate. However, it lacks information about the return format, maximum number of IDs allowed, or any response behavior. A score of 3 reflects this gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema already describes the 'ids' parameter with 100% coverage. The description merely restates 'based on provided IDs' without adding any extra context, constraints, or examples. According to the rules, baseline is 3 when schema coverage is high, so a score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Retrieve' and the resource 'names from the EVE Online Universe API.' It is specific and easy to understand. However, it does not differentiate from the sibling tool 'resolve_names_to_ids', which likely performs a similar function, so it loses a point for lack of sibling distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 'resolve_names_to_ids', nor does it mention prerequisites or context. A score of 2 reflects the absence of any usage recommendations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
market_pricesC
Fetch market prices from the EVE Online API.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided and description only says 'Fetch market prices' implying a read operation. Lacks disclosure of pagination, rate limits, or data format, which is necessary given no annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence of 7 words, very concise but may be too brief given the lack of detail. Could be expanded minimally to improve usefulness without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no output schema and no parameters, the description is minimally adequate but does not help the agent understand what data is returned or how to interpret results, especially among many sibling tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has zero parameters, baseline is 4. Description adds no extra parameter meaning, but no parameters exist to document.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states 'Fetch market prices from the EVE Online API' which is a clear verb+resource, but lacks specificity on scope (e.g., region, item) and does not differentiate from sibling tools that also fetch data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like get_region_history or region_orders. Does not address prerequisites or limitations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
public_contractsB
Retrieve public contracts for a specific region in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | The page of results to return. | |
| regionId | Yes | The ID of the region for which to retrieve public contracts. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description must convey behavioral traits. It only states 'Retrieve' which implies a read operation but does not explicitly confirm read-only behavior. It omits information about authentication requirements, rate limits, or side effects. The description is insufficiently transparent for a tool with no annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, concise sentence that front-loads the key information: action, resource, and scope. There is no redundancy or unnecessary detail, making it efficient for an AI agent to parse.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple retrieval tool with no output schema and two parameters, the description is minimally adequate. However, it lacks context such as pagination details or the fact that results are limited to public contracts only. Given the tool's complexity, additional information would enhance completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already documents both parameters ('regionId' and 'page') with descriptions. The tool description adds no additional meaning beyond what is in the schema. According to the scoring rule, the baseline is 3 when coverage is high, and the description does not improve upon it.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'Retrieve public contracts for a specific region in EVE Online' clearly states the action (retrieve), the resource (public contracts), and the scope (for a specific region). It is specific and distinguishes from sibling tools like 'region_orders' which are about market orders rather than contracts.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
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 does not mention prerequisites, limitations, or scenarios where other tools would be more appropriate. For example, it does not indicate that this tool returns contracts only for the given region and that other tools exist for more specific filtering.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
region_ordersB
Retrieve market orders for a specific type in a given region in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | The page number for pagination. | |
| type_id | No | The type ID of the item to fetch orders for. | |
| regionId | Yes | The ID of the region to fetch market orders from. | |
| order_type | No | The type of order to filter by. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description should disclose behavioral traits like pagination, filtering, or return format. It only states the basic action, omitting important details like the order_type filter or that results are paginated via the page parameter.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One clear sentence with no wasted words. Could be slightly expanded for added clarity, but it is concise and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that there are 4 parameters and no output schema, the description is too minimal. It fails to explain pagination, the meaning of order_type, or what the return data looks like.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
All parameters are described in the input schema (100% coverage), so the description adds no extra meaning. Baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states it retrieves market orders for a specific type in a region. Verb and resource are specific, and it distinguishes from sibling tools like market_prices and public_contracts.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives, such as when to use market_prices instead. Lacks any when-to-use or when-not-to guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
resolve_names_to_idsB
Resolve a set of names to IDs in EVE Online.
| Name | Required | Description | Default |
|---|---|---|---|
| names | Yes | An array of names to resolve to IDs. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden but only states the action. Lacks details on limitations, error handling, or any behavioral traits beyond the basic operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Concise single sentence, no wasted words. Could benefit from additional context without harming conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Minimally complete for a simple one-parameter tool, but lacks usage guidance and behavioral context. Adequate but with gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with a description for the 'names' parameter. Description adds no additional meaning beyond the schema, earning baseline 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Resolve' and the resource 'names to IDs' in EVE Online, distinguishing it from sibling tools like 'get_universe_names' which likely does the reverse.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives, such as 'get_universe_names' for reverse lookup. No mention of prerequisites or context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
Most tools target distinct resources (characters, corporations, market, universe), but there is some overlap between get_group_info and get_universe_groups, and get_region_info vs get_regions, which could cause confusion.
Tool names are mixed: some use 'character_' prefix, others 'get_', and some like 'market_prices' and 'resolve_names_to_ids' follow no consistent pattern. This inconsistency makes it harder to anticipate tool names.
With 37 tools, the server is large but still reasonably scoped to cover multiple EVE Online domains. However, it is above the typical 3-15 range, making it feel heavy.
The tool set covers many areas but misses critical EVE Online operations like skill management, industry jobs, wallet transactions, and mail sending, leaving significant gaps for agents.
Related MCP Connectors
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Remote MCP server for training, nutrition, wellness, and performance data with OAuth 2.0.
A Model Context Protocol (MCP) server for Selise Blocks Cloud integration
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.214MIT
- AlicenseNot gradedqualityDmaintenanceMCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.163MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.8MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server for querying the CVE-Search API. This server provides comprehensive access to CVE-Search, browse vendor and product、get CVE per CVE-ID、get the last updated CVEs.6103MIT
Appeared in Searches
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/kongyo2/eveonlineESI-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server