Examples and Integration Testing

This directory contains examples and resources for testing and integrating with the TAM MCP Server.

📄 Postman Collection

`TAM-MCP-Server-Postman-Collection.json`

A comprehensive Postman collection for testing all aspects of the TAM MCP Server API.

Verification Status: High success rate with comprehensive endpoint coverage

Features

Health Check: Server status and availability testing
Session Management: MCP session initialization and cleanup
Tool Testing: All 11 market analysis tools with sample requests
Resource Access: Documentation and endpoint access
Prompt Testing: Business analysis prompt generation
Error Handling: Edge cases and error scenarios
Performance Testing: Response time monitoring

Setup Instructions

Import Collection
- Open Postman
- Import TAM-MCP-Server-Postman-Collection.json

Set Environment Variables

{
  "serverUrl": "https://localhost:3000",
  "sessionId": "(automatically set after initialization)"
}

Start Server

npm run start:http  # or npm run start:sse

Run Tests
- Use collection runner for automated testing
- Run individual requests for manual testing
- Use Newman CLI for CI/CD: npx newman run TAM-MCP-Server-Postman-Collection.json

Automated Testing with Newman

# Install Newman (if not already installed)
npm install -g newman

# Run full test suite
npx newman run examples/TAM-MCP-Server-Postman-Collection.json --env-var serverUrl=https://localhost:3000

# Run with timeout for CI/CD
npx newman run examples/TAM-MCP-Server-Postman-Collection.json --env-var serverUrl=https://localhost:3000 --timeout-request 5000

Available Endpoints

Category	Endpoint	Description
Health	`/health`	Server status check
Session	`/initialize`	Start MCP session
Tools	`/tools/list`	List available tools
Tools	`/tools/call`	Execute specific tool
Resources	`/resources/list`	List documentation resources
Cleanup	`/session/close`	End MCP session

Tool Coverage

The collection includes test requests for key market analysis tools across all categories:

Basic Market Tools (4 tools):

industry_search - Find industries by keywords
tam_calculator - Calculate Total Addressable Market
market_size_calculator - Retrieve market size data
company_financials_retriever - Get company financial data

Business Analysis Tools (11 tools):

industry_analysis - Enhanced industry analysis
industry_data - Get detailed industry information
market_size - Advanced market size analysis
tam_analysis - Advanced TAM calculations
sam_calculator - Calculate Serviceable Markets
market_segments - Analyze market segmentation
market_forecasting - Generate market forecasts
market_comparison - Compare multiple markets
data_validation - Validate data quality
market_opportunities - Identify opportunities
generic_data_query - Direct data source access

Response Validation

Each request includes tests for:

HTTP status codes
Response structure validation
Data quality checks
Performance benchmarks
Error handling verification

🚀 Usage Examples

Quick API Test

# Start server
npm run start:http

# Import Postman collection
# Run "Health Check" request
# Run "Initialize Session" request
# Try any tool request

Automated Testing

# Use Postman CLI or Newman
newman run TAM-MCP-Server-Postman-Collection.json \
  --environment your-environment.json \
  --reporters cli,junit,html

Integration Examples

Connect from Claude Desktop with MCP configuration
Use with MCP Inspector for protocol debugging
Integrate with custom MCP clients

For more examples and integration guides, see the main documentation.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!