Skip to content

Getting Started

Follow these steps to set up and run the Toqan Apps MCP Server.

Step 1: Install Dependencies

Install the required npm packages:

bash
npm install

This will install:

  • fastify - Web server framework
  • @modelcontextprotocol/sdk - MCP protocol SDK
  • @fastify/cors - CORS support

Step 2: Start the Server

Start the MCP server:

bash
npm start

The server will start on http://localhost:3000 by default. You should see:

MCP server listening on http://localhost:3000/mcp

Step 3: Connect to Your Agent

Configure your Toqan agent to connect to the MCP server:

  • MCP Endpoint: http://localhost:3000/mcp
  • Protocol: HTTP (StreamableHTTPServerTransport)

The server exposes the following endpoints:

  • GET / - Health check
  • POST /mcp - MCP protocol endpoint
  • GET /website.html - Example HTML widget

Verify It's Working

  1. Check the health endpoint:

    bash
    curl http://localhost:3000/

    Should return: MCP server is running

  2. Test the MCP endpoint with your agent or MCP client

Next Steps