Skip to main content
The TrueFoundry MCP server exposes your platform as a set of tools that any MCP-compatible agent can call.
  • Server URL: https://<CONTROL_PLANE_URL>/api/svc/mcp
  • Auth: TrueFoundry API key as a Bearer token
  • Transport: Streamable HTTP
All actions run as the authenticated user. The server enforces the same RBAC as the dashboard and CLI.
When using the MCP server directly, you get the raw tools without the diff previews or approval flows available in Ask AI Agent. You can still pair it with TrueFoundry skills in any agent that supports the Agent Skills standard.

Authentication

Generate an API key from Settings > API Keys in the TrueFoundry dashboard.

Tools

Resource management

ToolRead / WriteDescription
apply_manifestWriteApply a manifest to create or update a resource.
delete_manifestWriteDelete a resource identified by the provided manifest.
validate_manifestReadValidate a manifest object against the schema for the given type.
get_manifest_json_schemaReadGet the JSON schema for the specified manifest type.

AI Gateway

ToolRead / WriteDescription
generate_multi_lang_code_snippetsReadGenerate code snippets for calling an AI Gateway model.
gateway_execute_sqlReadQuery AI Gateway observability data using SQL.
get_gateway_configReadGet the AI Gateway configuration for a given type.
get_budget_usageReadGet the current budget usage for every budget rule configured in the tenant.
list_data_routing_destinationsReadList data routing destination names for the current tenant.
list_mcp_serversReadList MCP servers for the current tenant.
get_mcp_serverReadGet a single MCP server by its ID.
delete_mcp_serverWritePermanently delete an MCP server by ID.
list_mcp_server_toolsReadList the tools available on a given MCP server.
list_mcp_catalogueReadReturns the TFY-managed MCP server catalogue and the MCP integrations catalogue.
get_mcp_server_oauth_configReadGet the OAuth authorization server configuration for an MCP server URL.

Provider accounts

ToolRead / WriteDescription
list_providersReadList all provider types along with their supported integrations, models, and model types.
list_provider_accountsReadList provider accounts the caller can read.
get_provider_accountReadGet a single provider account by its ID.

Secrets

ToolRead / WriteDescription
list_secretsReadList secrets the caller has access to.
delete_secretWriteDelete a secret and all its versions permanently.
list_secret_groupsReadList secret groups along with associated secrets. Secret values are not included.
get_secret_groupReadGet a secret group by ID.
list_secret_active_deploymentsReadGet active deployments associated with the given secret IDs.
get_secret_deploymentsReadList active deployments that reference a specific secret.

Identity and user management

ToolRead / WriteDescription
get_meReadReturns the identity and role information of the currently authenticated user or service account.
list_usersReadList users in the current tenant.
get_userReadGet a single user by their ID.
delete_userWritePermanently delete a user by ID.
check_user_registrationReadCheck whether a user with the given email is registered in the current tenant.

Teams

ToolRead / WriteDescription
list_teams_for_userReadList teams accessible to the current user.
get_teamReadGet a single team by its ID.
list_team_membersReadList users who are members of a team.
list_team_managersReadList users who hold the team-manager role on a team.
get_team_permissionsReadGet all role bindings associated with a team.
delete_teamWritePermanently delete a team.

Roles and access control

ToolRead / WriteDescription
list_rolesReadList roles for the current tenant.
delete_roleWritePermanently delete a role.
get_actions_for_resource_typeReadGet all permission actions available for a given resource type.

Virtual accounts and tokens

ToolRead / WriteDescription
list_virtual_accountsReadList virtual accounts accessible to the current user.
get_virtual_accountReadGet a single virtual account by its ID.
check_virtual_account_existsReadCheck whether a virtual account with the given name exists.
delete_virtual_accountWritePermanently delete a virtual account.
list_personal_access_tokensReadList personal access tokens created by the current user.
create_personal_access_tokenWriteCreate a new personal access token for the current user.
check_personal_access_token_existsReadCheck whether a personal access token with the given name exists.
delete_personal_access_tokenWritePermanently delete a personal access token.

Platform configuration

ToolRead / WriteDescription
list_settingsReadList all settings configured for the tenant.

Tool annotations

Every tool carries MCP annotations:
AnnotationMeaning
readOnlyHint: trueOnly reads data. Safe to call without confirmation.
destructiveHint: trueCreates, updates, or deletes a resource. Human confirmation recommended.