Edgee MCP Server

What is Edgee MCP Server about?

Edgee MCP Server offers a programmable interface to the Edgee platform, enabling developers to manage organizations, projects, components, and user accounts programmatically. It follows the Model Context Protocol, delivering clear error handling and strong type safety.

How to use Edgee MCP Server?

Installation

• Recommended (NPX): npx @edgee/mcp-server-edgee
• Global: npm install -g @edgee/mcp-server-edgee
• Local: npm install @edgee/mcp-server-edgee

Running the server

npx -y @edgee/mcp-server-edgee

Supply your personal access token via the environment variable EDGEE_TOKEN.

Claude Desktop integration

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "edgee": {
      "command": "npx",
      "args": ["-y", "@edgee/mcp-server-edgee"],
      "env": { "EDGEE_TOKEN": "<YOUR_TOKEN>" }
    }
  }
}

Key features of Edgee MCP Server

• Organization CRUD operations and user listing
• Project lifecycle management, domain handling, and statistics
• Component catalog, versioning, and settings manipulation
• User administration: invitations, API tokens, and profile retrieval
• Comprehensive, human‑readable error messages
• Fully typed API built with TypeScript

Use cases of Edgee MCP Server

• Automating onboarding of new organizations and teams
• Integrating project creation and component deployment into CI/CD pipelines
• Building custom dashboards that display project statistics and component statuses
• Managing user access and permissions programmatically for SaaS products
• Facilitating file uploads via presigned URLs in client applications

FAQ from the Edgee MCP Server

Q: How do I obtain a token? A: Create a Personal Access Token in Edgee Cloud under Account Settings → API Tokens and copy the generated value.

Q: Do I need to run the server locally? A: No, you can invoke it directly with npx each time or install it globally for repeated use.

Q: Which environment variable holds the token? A: Use EDGEE_TOKEN.

Q: Can I use the server with other MCP clients? A: Yes, any client that follows the Model Context Protocol can communicate with this server as long as the token is provided.

Q: Is the server open‑source? A: Yes, the source code is hosted on GitHub under the Apache‑2.0 license.

MCP Server for the Edgee API, enabling organization management, project operations, component management, and user administration through the Model Context Protocol.

Features

• Organization Management: Create, read, update, and delete organizations
• Project Operations: Manage projects, domains, components, and statistics
• Component Management: Work with components, versions, and settings
• User Administration: Manage users, invitations, and API tokens
• Comprehensive Error Handling: Clear error messages for common issues
• Type-Safe API: Built with TypeScript for robust type checking

Tools

Organization Tools

• edgee-listOrganizations: List all organizations with optional filtering
• edgee-getMyOrganization: Get your personal organization
• edgee-getOrganization: Get an organization by ID
• edgee-createOrganization: Create a new organization
• edgee-updateOrganization: Update an existing organization
• edgee-deleteOrganization: Delete an organization
• edgee-listOrganizationUsers: List users of an organization

Project Tools

• edgee-listProjects: List all projects with optional filtering
• edgee-getProject: Get a project by ID
• edgee-createProject: Create a new project
• edgee-updateProject: Update an existing project
• edgee-deleteProject: Delete a project
• edgee-getProjectCounters: Get statistics for a project
• edgee-listProjectDomains: List domains for a project
• edgee-createProjectDomain: Create a new domain for a project
• edgee-listProjectComponents: List components for a project

Component Tools

• edgee-listPublicComponents: List all public components
• edgee-listOrganizationComponents: List components for an organization
• edgee-getComponentByUuid: Get a component by UUID
• edgee-getComponentBySlug: Get a component by slug
• edgee-createComponent: Create a new component
• edgee-createComponentVersion: Create a new component version

User Tools

• edgee-getMe: Get the current user
• edgee-getUser: Get a user by ID
• edgee-listInvitations: List all invitations
• edgee-createInvitation: Create a new invitation
• edgee-deleteInvitation: Delete an invitation
• edgee-listApiTokens: List all API tokens
• edgee-createApiToken: Create a new API token
• edgee-deleteApiToken: Delete an API token
• edgee-getUploadPresignedUrl: Get a presigned URL for uploading files

Setup

Personal Access Token

Create an Edgee Personal Access Token:

• Go to API tokens (in Account Settings > API Tokens)
• Create a token
  • Give a name to this token
  • Select a validity period of the token you're about to create. If no duration is selected, the token will never expire.
• Copy the generated token

Installation

You can use this MCP server in several ways:

NPX (Recommended)

npx @edgee/mcp-server-edgee

Global Installation

npm install -g @edgee/mcp-server-edgee

Local Installation

npm install @edgee/mcp-server-edgee

Usage with Claude Desktop

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "edgee": {
      "command": "npx",
      "args": [
        "-y",
        "@edgee/mcp-server-edgee"
      ],
      "env": {
        "EDGEE_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Examples

List Organizations

Use the edgee-listOrganizations tool to list all your organizations.

Create a Project

Use the edgee-createProject tool to create a new project with the following parameters:
- organization_id: "org_123456"
- slug: "my-new-project"
- description: "This is my new project"

Get Project Components

Use the edgee-listProjectComponents tool to list all components for project "proj_123456".

Create an Invitation

Use the edgee-createInvitation tool to invite a user to your organization:
- organization_id: "org_123456"
- email: "user@example.com"
- role: "member"

Development

Building from Source

git clone https://github.com/edgee-cloud/mcp-server-edgee.git
cd mcp-server-edgee
npm install
npm run build

License

Apache-2.0