Documentation

Complete guide to getting started with MCP Pro

Documentation

Quick Start

Get up and running with MCP Pro in under 5 minutes.

Prerequisites: You'll need Claude Desktop or a custom MCP client to use MCP Pro.

Installation

Add MCP Pro to your Claude Desktop configuration:

{
  "mcpServers": {
    "mcp-pro": {
      "command": "npx",
      "args": ["@mcppro/client"],
      "env": {
        "MCP_PRO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

  • MCP_PRO_API_KEY - Your MCP Pro API key (required)
  • MCP_PRO_ENDPOINT - Custom endpoint URL (optional)

Authentication

MCP Pro uses API key authentication. Get your API key from the dashboard.

Security: Never commit your API key to version control. Use environment variables or secure configuration management.

API Reference

MCP Pro provides two core tools for dynamic tool discovery and execution:

search_tools

Search for available tools using natural language queries.

Parameters

  • query (string, required) - Natural language description of what you want to do
  • limit (number, optional) - Maximum number of results to return (default: 10)
  • category (string, optional) - Filter by tool category

Example

// Search for GitHub-related tools
{
  "tool": "search_tools",
  "arguments": {
    "query": "create github issue",
    "limit": 5
  }
}

Response

{
  "tools": [
    {
      "id": "github_create_issue",
      "name": "Create GitHub Issue",
      "description": "Create a new issue in a GitHub repository",
      "service": "github",
      "parameters": {
        "owner": "string",
        "repo": "string",
        "title": "string",
        "body": "string"
      },
      "required_credentials": ["github_token"]
    }
  ]
}

run_tool

Execute a specific tool with provided parameters and credentials.

Parameters

  • tool_id (string, required) - ID of the tool to execute
  • parameters (object, required) - Tool-specific parameters
  • credentials (object, required) - Required credentials for the tool

Example

{
  "tool": "run_tool",
  "arguments": {
    "tool_id": "github_create_issue",
    "parameters": {
      "owner": "mycompany",
      "repo": "myproject",
      "title": "Bug in user login",
      "body": "Users are unable to log in with their email address."
    },
    "credentials": {
      "github_token": "ghp_xxxxxxxxxxxx"
    }
  }
}

Examples

Create a GitHub Issue and Notify Team

// 1. Search for GitHub tools
{
  "tool": "search_tools",
  "arguments": {
    "query": "github create issue"
  }
}

// 2. Create the issue
{
  "tool": "run_tool",
  "arguments": {
    "tool_id": "github_create_issue",
    "parameters": {
      "owner": "mycompany",
      "repo": "website",
      "title": "Fix navigation bug",
      "body": "Navigation menu not working on mobile"
    },
    "credentials": {
      "github_token": "your_token"
    }
  }
}

// 3. Search for Slack tools
{
  "tool": "search_tools",
  "arguments": {
    "query": "slack send message notify team"
  }
}

// 4. Notify the team
{
  "tool": "run_tool",
  "arguments": {
    "tool_id": "slack_send_message",
    "parameters": {
      "channel": "#dev-team",
      "text": "New GitHub issue created: Fix navigation bug"
    },
    "credentials": {
      "slack_token": "your_slack_token"
    }
  }
}

AWS Resource Management

// Search for AWS EC2 tools
{
  "tool": "search_tools",
  "arguments": {
    "query": "aws ec2 instances list"
  }
}

// List EC2 instances
{
  "tool": "run_tool",
  "arguments": {
    "tool_id": "aws_ec2_list_instances",
    "parameters": {
      "region": "us-east-1"
    },
    "credentials": {
      "aws_access_key": "your_access_key",
      "aws_secret_key": "your_secret_key"
    }
  }
}

Troubleshooting

Common Issues

Authentication Failed

If you're getting authentication errors:

  • Verify your API key is correct
  • Check that the API key is properly set in your environment
  • Ensure your subscription is active

Tool Not Found

If a tool isn't found in search results:

  • Try different search terms or be more specific
  • Check if the service is supported in your plan
  • Browse the MCP Servers directory for available tools

Credential Errors

If you're having issues with credentials:

  • Verify your service API keys are valid
  • Check that you have the required permissions
  • Ensure credentials are properly formatted

Getting Help

Need more help? Reach out to our support team: