@open-mcp/agenta-ai

Using the remote server

To use the hosted Streamable HTTP server, add the following to your client config:

{
  "mcpServers": {
    "agenta-ai": {
      "transport": "streamableHttp",
      "url": "https://mcp.open-mcp.org/api/server/agenta-ai@latest/mcp"
    }
  }
}

Forwarding variables

You can forward "environment" variables to the remote server by including them in the request headers or URL query string (headers take precedence). Just prefix the variable name with FORWARD_VAR_ like so:

https://mcp.open-mcp.org/api/server/agenta-ai@latest/mcp?FORWARD_VAR_OPEN_MCP_BASE_URL=https%3A%2F%2Fapi.example.com

Installing locally

If you want to run the server locally on your own machine instead of using the remote server, first set the environment variables as shell variables:

AUTHORIZATION='...'

Then use the OpenMCP config CLI to add the server to your MCP client:

Claude desktop

npx @open-mcp/config add agenta-ai \
  ~/Library/Application\ Support/Claude/claude_desktop_config.json \
  --AUTHORIZATION=$AUTHORIZATION

Cursor

Run this from the root of your project directory or, to add to all cursor projects, run it from your home directory ~.

npx @open-mcp/config add agenta-ai \
  .cursor/mcp.json \
  --AUTHORIZATION=$AUTHORIZATION

Other

npx @open-mcp/config add agenta-ai \
  /path/to/client/config.json \
  --AUTHORIZATION=$AUTHORIZATION

Manually

If you don't want to use the helper above, add the following to your MCP client config manually:

{
  "mcpServers": {
    "agenta-ai": {
      "command": "npx",
      "args": ["-y", "@open-mcp/agenta-ai"],
      "env": {"AUTHORIZATION":"..."}
    }
  }
}

Environment variables

• OPEN_MCP_BASE_URL - overwrites the base URL of every tool's underlying API request
• AUTHORIZATION - gets sent to the API provider

Tools

expandSchema

Expand the input schema for a tool before calling the tool

Input schema

• toolName (string)
• jsonPointers (array)

create_accounts

Environment variables

• AUTHORIZATION

Input schema

• users (object)
• organizations (object)
• workspaces (object)
• projects (object)
• organization_memberships (object)
• workspace_memberships (object)
• project_memberships (object)

create_account

Environment variables

• AUTHORIZATION

Input schema

• user (object)
• scope (object)

get_own_org

Environment variables

• AUTHORIZATION

Input schema

No input parameters

fetch_organization_details

Environment variables

• AUTHORIZATION

Input schema

• org_id (string)

update_organization

Environment variables

• AUTHORIZATION

Input schema

• org_id (string)
• name (other)
• description (other)
• updated_at (other)

create_workspace

Environment variables

• AUTHORIZATION

Input schema

• org_id (string)
• name (string)
• description (other)
• type (other)

update_workspace

Environment variables

• AUTHORIZATION

Input schema

• org_id (string)
• workspace_id (string)
• name (other)
• description (other)
• updated_at (other)

get_all_workspace_permissions

Environment variables

• AUTHORIZATION

Input schema

No input parameters

assign_role_to_user

Environment variables

• AUTHORIZATION

Input schema

• workspace_id (string)
• email (string)
• organization_id (string)
• role (other)

unassign_role_from_user

Environment variables

• AUTHORIZATION

Input schema

• workspace_id (string)
• email (string)
• org_id (string)
• role (string)

fetch_evaluation_ids_evaluations_by_resource_get

Environment variables

• AUTHORIZATION

Input schema

• resource_type (string)
• resource_ids (array)

create_evaluation

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• revisions_ids (array)
• evaluators_configs (array)
• testset_id (string)
• rate_limit (object)
• correct_answer_column (other)

fetch_list_evaluations_evaluations_get

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)

delete_evaluations

Environment variables

• AUTHORIZATION

Input schema

• evaluations_ids (array)

fetch_evaluation_status

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)

fetch_evaluation_results

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)

fetch_evaluation_scenarios

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)

fetch_evaluation

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)

fetch_evaluation_scenarios_evaluations_evaluation_scenarios_comp

Environment variables

• AUTHORIZATION

Input schema

• evaluations_ids (string)

create_human_evaluation

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• variant_ids (array)
• evaluation_type (string)
• inputs (array)
• testset_id (string)
• status (string)

fetch_list_human_evaluations_human_evaluations_get

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)

delete_evaluations_human_evaluations_delete

Environment variables

• AUTHORIZATION

Input schema

• evaluations_ids (array)

fetch_human_evaluation_human_evaluations_evaluation_id_get

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)

update_human_evaluation

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)
• status (other)

fetch_human_evaluation_scenarios

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)

update_evaluation_scenario_router_human_evaluations_evaluation_i

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)
• evaluation_scenario_id (string)
• evaluation_type (string)
• vote (other)
• score (other)
• correct_answer (other)
• outputs (other)
• inputs (other)
• is_pinned (other)
• note (other)

get_evaluation_scenario_score_router_human_evaluations_evaluatio

Environment variables

• AUTHORIZATION

Input schema

• evaluation_scenario_id (string)

update_evaluation_scenario_score_router_human_evaluations_evalua

Environment variables

• AUTHORIZATION

Input schema

• evaluation_scenario_id (string)
• score (number)

fetch_results

Environment variables

• AUTHORIZATION

Input schema

• evaluation_id (string)

handle_events

Environment variables

• AUTHORIZATION

Input schema

No input parameters

create_portal

Environment variables

• AUTHORIZATION

Input schema

No input parameters

create_checkout

Environment variables

• AUTHORIZATION

Input schema

• plan (string)
• success_url (string)

fetch_plans

Environment variables

• AUTHORIZATION

Input schema

No input parameters

switch_plans

Environment variables

• AUTHORIZATION

Input schema

• plan (string)

fetch_subscription

Environment variables

• AUTHORIZATION

Input schema

No input parameters

cancel_plan

Environment variables

• AUTHORIZATION

Input schema

No input parameters

fetch_usage

Environment variables

• AUTHORIZATION

Input schema

No input parameters

admin_create_portal

Environment variables

• AUTHORIZATION

Input schema

• organization_id (string)

admin_create_checkout

Environment variables

• AUTHORIZATION

Input schema

• organization_id (string)
• plan (string)
• success_url (string)

admin_switch_plans

Environment variables

• AUTHORIZATION

Input schema

• organization_id (string)
• plan (string)

admin_cancel_subscription

Environment variables

• AUTHORIZATION

Input schema

• organization_id (string)

admin_report_usage

Environment variables

• AUTHORIZATION

Input schema

No input parameters

health_check

Environment variables

• AUTHORIZATION

Input schema

No input parameters

verify_permissions

Environment variables

• AUTHORIZATION

Input schema

• action (other)
• scope_type (other)
• scope_id (other)
• resource_type (other)
• resource_id (other)

get_projects

Environment variables

• AUTHORIZATION

Input schema

No input parameters

fetch_user_profile

Environment variables

• AUTHORIZATION

Input schema

No input parameters

reset_user_password

Environment variables

• AUTHORIZATION

Input schema

• user_id (string)

list_app_variants

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)

get_variant_by_env

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• environment (string)

create_app

Environment variables

• AUTHORIZATION

Input schema

• app_name (string)
• template_key (other)
• project_id (other)
• workspace_id (other)
• organization_id (other)

list_apps

Environment variables

• AUTHORIZATION

Input schema

• app_name (other)

update_app

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• app_name (string)

remove_app

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)

add_variant_from_url

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• variant_name (string)
• url (string)
• commit_message (other)
• base_name (other)
• config_name (other)

add_variant_from_key

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• variant_name (string)
• key (string)
• commit_message (other)
• base_name (other)
• config_name (other)

list_environments

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)

environment_revisions

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• environment_name (other)

add_variant_from_base_and_config

Environment variables

• AUTHORIZATION

Input schema

• base_id (string)
• new_variant_name (string)
• new_config_name (string)
• parameters (object)
• commit_message (other)

mark_variant_as_hidden

Environment variables

• AUTHORIZATION

Input schema

• variant_id (string)

get_variant

Environment variables

• AUTHORIZATION

Input schema

• variant_id (string)

update_variant_parameters

Environment variables

• AUTHORIZATION

Input schema

• variant_id (string)
• parameters (object)
• commit_message (other)

update_variant_url

Environment variables

• AUTHORIZATION

Input schema

• url (string)
• variant_id (string)
• commit_message (other)

get_variant_revisions

Environment variables

• AUTHORIZATION

Input schema

• variant_id (string)

get_variant_revision

Environment variables

• AUTHORIZATION

Input schema

• variant_id (string)
• revision_number (integer)

mark_variant_revision_as_hidden

Environment variables

• AUTHORIZATION

Input schema

• variant_id (string)
• revision_id (string)

configs_add

Environment variables

• AUTHORIZATION

Input schema

• variant_ref (object)
• application_ref (object)

configs_fetch

Environment variables

• AUTHORIZATION

Input schema

• variant_ref (other)
• environment_ref (other)
• application_ref (other)

configs_fork

Environment variables

• AUTHORIZATION

Input schema

• variant_ref (other)
• environment_ref (other)
• application_ref (other)

configs_commit

Environment variables

• AUTHORIZATION

Input schema

• config (object)

configs_deploy

Environment variables

• AUTHORIZATION

Input schema

• variant_ref (object)
• environment_ref (object)
• application_ref (other)

configs_delete

Environment variables

• AUTHORIZATION

Input schema

• variant_ref (object)
• application_ref (other)

configs_list

Environment variables

• AUTHORIZATION

Input schema

• application_ref (object)

configs_history

Environment variables

• AUTHORIZATION

Input schema

• variant_ref (object)
• application_ref (other)

container_templates

Environment variables

• AUTHORIZATION

Input schema

No input parameters

get_evaluators_endpoint_evaluators_get

Environment variables

• AUTHORIZATION

Input schema

No input parameters

evaluator_data_map_evaluators_map_post

Environment variables

• AUTHORIZATION

Input schema

• inputs (object)
• mapping (object)

evaluator_run_evaluators_evaluator_key_run_post

Environment variables

• AUTHORIZATION

Input schema

• evaluator_key (string)
• inputs (object)
• settings (other)
• credentials (other)

get_evaluator_configs_evaluators_configs_get

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)

create_new_evaluator_config_evaluators_configs_post

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• name (string)
• evaluator_key (string)
• settings_values (object)

get_evaluator_config_evaluators_configs_evaluator_config_id_get

Environment variables

• AUTHORIZATION

Input schema

• evaluator_config_id (string)

update_evaluator_config_evaluators_configs_evaluator_config_id_p

Environment variables

• AUTHORIZATION

Input schema

• evaluator_config_id (string)
• name (other)
• evaluator_key (other)
• settings_values (other)

delete_evaluator_config_evaluators_configs_evaluator_config_id_d

Environment variables

• AUTHORIZATION

Input schema

• evaluator_config_id (string)

upload_file

Environment variables

• AUTHORIZATION

Input schema

No input parameters

import_testset

Environment variables

• AUTHORIZATION

Input schema

• authorization (other)

get_testsets

Environment variables

• AUTHORIZATION

Input schema

No input parameters

create_testset

Environment variables

• AUTHORIZATION

Input schema

• name (string)
• csvdata (array)

delete_testsets

Environment variables

• AUTHORIZATION

Input schema

• testset_ids (array)

update_testset

Environment variables

• AUTHORIZATION

Input schema

• testset_id (string)
• name (string)
• csvdata (array)

get_single_testset

Environment variables

• AUTHORIZATION

Input schema

• testset_id (string)

deploy_to_environment

Environment variables

• AUTHORIZATION

Input schema

• environment_name (string)
• variant_id (string)
• commit_message (other)

list_bases

Environment variables

• AUTHORIZATION

Input schema

• app_id (string)
• base_name (other)

get_config

Environment variables

• AUTHORIZATION

Input schema

• base_id (string)
• config_name (other)
• environment_name (other)

get_config_deployment_revision

Environment variables

• AUTHORIZATION

Input schema

• deployment_revision_id (string)

revert_deployment_revision

Environment variables

• AUTHORIZATION

Input schema

• deployment_revision_id (string)

list_api_keys

Environment variables

• AUTHORIZATION

Input schema

No input parameters

create_api_key

Environment variables

• AUTHORIZATION

Input schema

No input parameters

delete_api_key

Environment variables

• AUTHORIZATION

Input schema

• key_prefix (string)

list_organizations

Environment variables

• AUTHORIZATION

Input schema

No input parameters

invite_user_to_workspace

Environment variables

• AUTHORIZATION

Input schema

• org_id (string)
• workspace_id (string)

resend_invitation

Environment variables

• AUTHORIZATION

Input schema

• org_id (string)
• workspace_id (string)
• email (string)

accept_invitation

Environment variables

• AUTHORIZATION

Input schema

• org_id (string)
• workspace_id (string)
• project_id (string)
• token (string)
• email (string)

get_workspace

Environment variables

• AUTHORIZATION

Input schema

No input parameters

get_all_workspace_roles

Environment variables

• AUTHORIZATION

Input schema

No input parameters

remove_user_from_workspace

Environment variables

• AUTHORIZATION

Input schema

• workspace_id (string)
• email (string)

otlp_v1_traces

Environment variables

• AUTHORIZATION

Input schema

No input parameters

otlp_status

Environment variables

• AUTHORIZATION

Input schema

No input parameters

otlp_receiver

Environment variables

• AUTHORIZATION

Input schema

No input parameters

query_traces

Environment variables

• AUTHORIZATION

Input schema

• format (string)
• focus (other)
• oldest (other)
• newest (other)
• filtering (other)
• page (other)
• size (other)
• next (other)
• stop (other)

delete_traces

Environment variables

• AUTHORIZATION

Input schema

• node_id (string)
• node_ids (array)

query_analytics

Environment variables

• AUTHORIZATION

Input schema

• format (string)
• focus (other)
• oldest (other)
• newest (other)
• window (other)
• filtering (other)
• timeRange (other)
• app_id (other)
• environment (other)
• variant (other)

fetch_trace_by_id

Environment variables

• AUTHORIZATION

Input schema

• trace_id (other)
• format (string)

list_secrets

Environment variables

• AUTHORIZATION

Input schema

No input parameters

create_secret

Environment variables

• AUTHORIZATION

Input schema

• header (object)
• secret (object)

read_secret

Environment variables

• AUTHORIZATION

Input schema

• secret_id (string)

update_secret

Environment variables

• AUTHORIZATION

Input schema

• secret_id (string)
• header (other)
• secret (other)

delete_secret

Environment variables

• AUTHORIZATION

Input schema

• secret_id (string)