AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
TypeScript ai-agentai-agent-toolsai-agentsai-agents-frameworkmcpmcp-servermcp-toolsmcpsn8n-alternativeno-code-automationworkflowworkflow-automationworkflows
import { AiProviderKeyStatus, AIProviderName } from '@activepieces/core-utils'
import { modelTierCatalog } from '@activepieces/server-utils'
import { AIProviderModel, AIProviderWithoutSensitiveData, CreateAIProviderRequest, ModelOptions, ModelOptionsSurface, PrincipalType, SERVICE_KEY_SECURITY_OPENAPI, spreadIfDefined, UpdateAIProviderRequest } from '@activepieces/shared'
import { FastifyRequest } from 'fastify'
import { FastifyPluginAsyncZod } from 'fastify-type-provider-zod'
import { StatusCodes } from 'http-status-codes'
import { z } from 'zod'
import { ProjectResourceType } from '../core/security/authorization/common'
import { securityAccess } from '../core/security/authorization/fastify-security'
import { aiModelOptionsService } from './ai-model-options-service'
import { aiProviderService } from './ai-provider-service'
export const aiProviderController: FastifyPluginAsyncZod = async (app) => {
app.get('/', ListAIProvidersForProject, async (request) => {
return aiProviderService(app.log).listForProject({
platformId: request.principal.platform.id,
projectId: request.projectId,
})
})
app.get('/configs', ListAIProviderConfigs, async (request) => {
return aiProviderService(app.log).listConfigs(request.principal.platform.id)
})
app.get('/configs/:id/models', ListModelsForConfig, async (request) => {
return aiProviderService(app.log).listModelsForConfig({
platformId: request.principal.platform.id,
configId: request.params.id,
})
})
app.get('/configs/:id/suggested-models', ListSuggestedModelsForConfig, async (request) => {
return aiProviderService(app.log).suggestModelsForConfig({
platformId: request.principal.platform.id,
configId: request.params.id,
})
})
app.get('/tiers', ListModelTiers, async () => ({
flow: modelTierCatalog.current('flow'),
chat: modelTierCatalog.current('chat'),
}))
app.get('/model-options', ListModelOptions, async (request) => {
return aiModelOptionsService(app.log).list({
platformId: request.principal.platform.id,
projectId: request.projectId,
surface: request.query.surface,
tierId: request.query.tierId,
})
})
app.get('/model-options/platform', ListPlatformModelOptions, async (request) => {
return aiModelOptionsService(app.log).listForPlatform({
platformId: request.principal.platform.id,
surface: request.query.surface,
platformDefault: null,
})
})
app.get('/:provider/models', ListModels, async (request) => {
return aiProviderService(app.log).listModels({
platformId: request.principal.platform.id,
provider: request.params.provider,
scope: { type: 'project', projectId: request.projectId },
...spreadIfDefined('configId', request.query.configId),
})
})
app.post('/', CreateAIProvider, async (request) => {
const platformId = request.principal.platform.id
return aiProviderService(app.log).create(platformId, request.body)
})
app.post('/:id/recheck', RecheckAIProvider, async (request) => {
const status = await aiProviderService(app.log).recheck({
platformId: request.principal.platform.id,
providerId: request.params.id,
})
return { status }
})
app.post('/:id', UpdateAIProvider, async (request) => {
const platformId = request.principal.platform.id
const service = aiProviderService(app.log)
await service.update(platformId, request.params.id, request.body)
return service.getConfig({ platformId, configId: request.params.id })
})
app.delete('/:id', DeleteAIProvider, async (request, reply) => {
const platformId = request.principal.platform.id
await aiProviderService(app.log).delete(platformId, request.params.id)
return reply.status(StatusCodes.NO_CONTENT).send()
})
}
const ListAIProvidersForProject = {
config: {
security: securityAccess.project([PrincipalType.USER, PrincipalType.ENGINE], undefined, { type: ProjectResourceType.QUERY }),
},
schema: {
querystring: z.object({
projectId: z.string().optional(),
}),
},
}
const ListAIProviderConfigs = {
config: {
security: securityAccess.platformAdminOnly([PrincipalType.USER, PrincipalType.SERVICE]),
},
schema: {
tags: ['ai-providers'],
security: [SERVICE_KEY_SECURITY_OPENAPI],
description: 'List the AI provider keys connected to the platform. Secrets are never returned.',
response: {
[StatusCodes.OK]: z.array(AIProviderWithoutSensitiveData),
},
},
}
const ListModelsForConfig = {
config: {
security: securityAccess.platformAdminOnly([PrincipalType.USER, PrincipalType.SERVICE]),
},
schema: {
tags: ['ai-providers'],
security: [SERVICE_KEY_SECURITY_OPENAPI],
description: 'List the models an AI provider key can run.',
params: z.object({
id: z.string(),
}),
response: {
[StatusCodes.OK]: z.array(AIProviderModel),
},
},
}
const ListSuggestedModelsForConfig = {
config: {
security: securityAccess.platformAdminOnly([PrincipalType.USER, PrincipalType.SERVICE]),
},
schema: {
tags: ['ai-providers'],
security: [SERVICE_KEY_SECURITY_OPENAPI],
description: 'Suggest model ids for a key whose provider has no model list (Other, OpenAI compatible).',
params: z.object({
id: z.string(),
}),
response: {
[StatusCodes.OK]: z.array(z.string()),
},
},
}
const ModelTierList = z.object({
tiers: z.array(z.object({
id: z.string(),
label: z.string(),
modelId: z.string(),
})),
defaultTierId: z.string(),
})
const ListModelTiers = {
config: {
security: securityAccess.unscoped([PrincipalType.USER, PrincipalType.ENGINE]),
},
schema: {
response: {
[StatusCodes.OK]: z.object({
flow: ModelTierList,
chat: ModelTierList,
}),
},
},
}
const ListModelOptions = {
config: {
security: securityAccess.project([PrincipalType.USER], undefined, { type: ProjectResourceType.QUERY }),
},
schema: {
querystring: z.object({
projectId: z.string().optional(),
surface: ModelOptionsSurface,
tierId: z.string().optional(),
}),
response: {
[StatusCodes.OK]: ModelOptions,
},
},
}
const ListPlatformModelOptions = {
config: {
security: securityAccess.platformAdminOnly([PrincipalType.USER, PrincipalType.SERVICE]),
},
schema: {
tags: ['ai-providers'],
security: [SERVICE_KEY_SECURITY_OPENAPI],
description: 'List every model the platform can offer for a surface (chat or flows), grouped by key.',
querystring: z.object({
surface: ModelOptionsSurface,
}),
response: {
[StatusCodes.OK]: ModelOptions,
},
},
}
const ListModels = {
config: {
security: securityAccess.project([PrincipalType.USER, PrincipalType.ENGINE], undefined, { type: ProjectResourceType.QUERY }),
},
schema: {
params: z.object({
provider: z.nativeEnum(AIProviderName),
}),
querystring: z.object({
projectId: z.string().optional(),
configId: z.string().optional(),
}),
response: {
[StatusCodes.OK]: z.array(AIProviderModel),
},
},
}
const CreateAIProvider = {
config: {
security: securityAccess.platformAdminOnly([PrincipalType.USER, PrincipalType.SERVICE]),
},
preHandler: (request: FastifyRequest): Promise<void> => aiProviderService(request.log).assertAiProvidersPlan(request.principal.platform.id),
schema: {
tags: ['ai-providers'],
security: [SERVICE_KEY_SECURITY_OPENAPI],
description: 'Connect a new AI provider key. The credentials are checked with the provider before saving.',
body: CreateAIProviderRequest,
response: {
[StatusCodes.OK]: AIProviderWithoutSensitiveData,
},
},
}
const RecheckAIProvider = {
config: {
security: securityAccess.platformAdminOnly([PrincipalType.USER, PrincipalType.SERVICE]),
},
schema: {
tags: ['ai-providers'],
security: [SERVICE_KEY_SECURITY_OPENAPI],
description: 'Check an AI provider key against its provider again and return its status.',
params: z.object({
id: z.string(),
}),
response: {
[StatusCodes.OK]: z.object({
status: AiProviderKeyStatus,
}),
},
},
}
const UpdateAIProvider = {
config: {
security: securityAccess.platformAdminOnly([PrincipalType.USER, PrincipalType.SERVICE]),
},
schema: {
tags: ['ai-providers'],
security: [SERVICE_KEY_SECURITY_OPENAPI],
description: 'Update an AI provider key: its name, credentials, model scope or project access.',
params: z.object({
id: z.string(),
}),
body: UpdateAIProviderRequest,
response: {
[StatusCodes.OK]: AIProviderWithoutSensitiveData,
},
},
}
const DeleteAIProvider = {
config: {
security: securityAccess.platformAdminOnly([PrincipalType.USER, PrincipalType.SERVICE]),
},
schema: {
tags: ['ai-providers'],
security: [SERVICE_KEY_SECURITY_OPENAPI],
description: 'Delete an AI provider key. Fails while a tier still uses it.',
params: z.object({
id: z.string(),
}),
response: {
[StatusCodes.NO_CONTENT]: z.never(),
},
},
}