Server Submission

Submission Process

Submit your MCP server to Testra's directory in 4 simple steps:

1. Prepare Your Server

Ensure your server meets all requirements:

• ✅ MCP v1.0+ compliance

• ✅ All required endpoints implemented

• ✅ Comprehensive documentation

• ✅ Stable deployment (99%+ uptime)

---

2. Submit Server Information

# Interactive submission
testra submit

# Or provide details directly
testra submit \
  --name "My Price Oracle" \
  --url "https://api.myprice.com" \
  --category "defi" \
  --description "Real-time crypto prices" \
  --repository "https://github.com/user/my-oracle"

---

3. Verification Process

Testra automatically verifies your server:

Automated Checks (5-10 minutes):

• MCP protocol compliance

• Endpoint availability

• Response format validation

• Basic security scan

Manual Review (24-48 hours):

• Code quality review (if open source)

• Documentation completeness

• Security assessment

• Community guidelines compliance

---

4. Go Live

Once approved, your server appears in the directory:

• Listed in relevant categories

• Available for testing via Live Inspector

• Monitored for uptime and performance

• Indexed for search discovery

---

Submission Requirements

Server Information

Basic Details:

{
  "name": "Server Name",
  "description": "Detailed description of functionality",
  "category": "defi|gaming|data|ai|tools",
  "tags": ["price-feed", "ethereum", "real-time"],
  "version": "1.0.0",
  "mcpVersion": "1.0.0"
}

---

Endpoints:

{
  "baseUrl": "https://api.yourserver.com",
  "healthPath": "/health",
  "capabilitiesPath": "/capabilities", 
  "executePath": "/execute"
}

---

Maintainer Information:

{
  "name": "Your Name",
  "email": "[email protected]",
  "organization": "Your Company",
  "website": "https://yourserver.com"
}

---

Documentation Requirements

API Documentation:

• Complete function descriptions

• Parameter specifications with examples

• Return value schemas

• Error codes and handling

---

Integration Examples:

• JavaScript/Node.js examples

• Python examples

• cURL commands

• SDK integration samples

---

README.md Structure:

# Server Name

## Description
Brief description of what your server does.

## Functions
List of available functions with descriptions.

## Quick Start
```javascript
// Example usage

---

Authentication

How to authenticate with your server.

---

Rate Limits

Request limits and quotas.

---

Support

How to get help or report issues.

Submission Form Fields

When submitting via the web interface, provide:

Server Details:

• Name: Display name for your server

• Description: Detailed explanation of functionality

• Base URL: Your server's base endpoint

• Category: Primary category (DeFi, Gaming, etc.)

• Tags: Searchable keywords

• Version: Current server version

Code & Documentation:

• Repository URL: Link to source code (if open source)

• Documentation URL: Link to API docs

• License: Software license type

• Changelog: Version history and updates

Contact Information:

• Maintainer Name: Primary contact person

• Email: Support email address

• Organization: Company or project name

• Website: Official website

Optional Enhancements:

• Security Audit: Upload audit reports

• Performance Benchmarks: Load testing results

• Deployment Guide: Self-hosting instructions

• Business Model: Pricing and usage terms

---

CLI Submission

Use the Testra CLI for programmatic submissions:

# Login to Testra
testra auth login

# Initialize submission
testra submit init

# This creates a testra.config.json file:
{
  "name": "My MCP Server",
  "description": "Server description",
  "category": "defi",
  "tags": ["price", "oracle"],
  "baseUrl": "https://api.myserver.com",
  "repository": "https://github.com/user/server",
  "maintainer": {
    "name": "Developer Name",
    "email": "[email protected]"
  }
}

# Submit server
testra submit --config testra.config.json

# Check submission status
testra status submission-id