Edgee

The Edgee MCP Server provides a typed, API-driven way to manage organizations, projects, components, and users through the Model Context Protocol. It enables you to operate and automate administration tasks with clear error handling and robust type safety in a reusable server you can run locally or remotely.

How to use

You use the Edgee MCP Server by starting a local instance or running it through a package manager, then connecting your MCP client to perform day-to-day management tasks. You can list and manage organizations, create projects and domains, handle components and their versions, invite and administer users, and derive project statistics. Use the provided tools to perform actions like listing entities, creating new items, updating existing ones, and deleting items as needed. The server organizes actions by scope (organization, project, component, user) to help you structure automation and workflows.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine. You can verify with node --version and npm --version.

Install using NPX (recommended): to run the MCP Server without a global installation, use NPX.

# Run the MCP server directly with NPX
npx @edgee/mcp-server-edgee

Global installation: install the MCP Server globally so you can invoke it from anywhere on your system.

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

Local installation: add the MCP Server to a project, then run from your project context.

npm install @edgee/mcp-server-edgee

Token-based configuration for clients (used with Claude Desktop integration): you may supply your authentication token to the client configuration. In Claude Desktop, set the token through the EDGEE_TOKEN environment variable when launching or configuring your MCP server connection.

Additional content

Personal access tokens guide: you can create a Personal Access Token to authenticate with the Edgee API. To create one, go to Account Settings > API Tokens, create a token, give it a descriptive name, and choose a validity period. If no duration is chosen, the token never expires. Copy the generated token and use it in your client configuration.

Claude Desktop configuration: you can connect your client by providing a config snippet that runs the MCP server via NPX and passes the token through an environment variable. Example config is shown below for your reference.

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

Available tools

listOrganizations

List all organizations with optional filtering.

getMyOrganization

Retrieve your personal organization.

getOrganization

Retrieve an organization by ID.

createOrganization

Create a new organization.

updateOrganization

Update an existing organization.

deleteOrganization

Delete an organization.

listOrganizationUsers

List users within an organization.

listProjects

List all projects with optional filtering.

getProject

Get a project by ID.

createProject

Create a new project.

updateProject

Update an existing project.

deleteProject

Delete a project.

getProjectCounters

Get statistics for a project.

listProjectDomains

List domains for a project.

createProjectDomain

Create a new domain for a project.

listProjectComponents

List components for a project.

listPublicComponents

List all public components.

listOrganizationComponents

List components for an organization.

getComponentByUuid

Get a component by UUID.

getComponentBySlug

Get a component by slug.

createComponent

Create a new component.

createComponentVersion

Create a new component version.

getMe

Get the current user.

getUser

Get a user by ID.

listInvitations

List all invitations.

createInvitation

Create a new invitation.

deleteInvitation

Delete an invitation.

listApiTokens

List all API tokens.

createApiToken

Create a new API token.

deleteApiToken

Delete an API token.

getUploadPresignedUrl

Get a presigned URL for uploading files.