naftiko: 1.0.0-alpha2
info:
  label: Vercel AI Development Platform
  description: Unified workflow capability for AI-powered application development using Vercel's AI platform. Enables developers
    and AI agents to generate full-stack web applications via v0, query and compare AI models via the AI Gateway, and create
    text embeddings for semantic search and retrieval applications. Designed for developers building AI-native applications
    on the Vercel platform.
  tags:
  - Vercel
  - AI
  - Code Generation
  - LLM
  - AI Gateway
  - Developer Tools
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    AI_GATEWAY_API_KEY: AI_GATEWAY_API_KEY
    V0_API_KEY: V0_API_KEY
capability:
  consumes:
  - type: http
    namespace: vercel-ai-gateway
    baseUri: https://ai-gateway.vercel.sh
    description: Vercel AI Gateway — unified LLM API across providers
    authentication:
      type: bearer
      token: '{{AI_GATEWAY_API_KEY}}'
    resources:
    - name: models
      path: /v1/models
      description: Available AI models
      operations:
      - name: list-models
        method: GET
        description: List all available AI models across all providers
        inputParameters: []
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: chat-completions
      path: /v1/chat/completions
      description: Chat completions across AI providers
      operations:
      - name: create-chat-completion
        method: POST
        description: Create a chat completion using any model via the AI Gateway
        inputParameters: []
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            model: '{{tools.model}}'
            messages: '{{tools.messages}}'
            stream: '{{tools.stream}}'
            temperature: '{{tools.temperature}}'
            max_tokens: '{{tools.max_tokens}}'
    - name: embeddings
      path: /v1/embeddings
      description: Text embeddings
      operations:
      - name: create-embedding
        method: POST
        description: Create text embeddings using any embedding model
        inputParameters: []
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            model: '{{tools.model}}'
            input: '{{tools.input}}'
  - type: http
    namespace: vercel-v0
    baseUri: https://v0.dev/api
    description: Vercel v0 AI-powered app generation API
    authentication:
      type: bearer
      token: '{{V0_API_KEY}}'
    resources:
    - name: chat
      path: /v1/chat
      description: AI app generation chat sessions
      operations:
      - name: create-chat
        method: POST
        description: Generate a web app from a natural language prompt
        inputParameters: []
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            message: '{{tools.message}}'
            system: '{{tools.system}}'
    - name: chat-by-id
      path: /v1/chat/{chatId}
      description: Individual chat session management
      operations:
      - name: get-chat
        method: GET
        description: Get details for an existing v0 chat session
        inputParameters:
        - name: chatId
          in: path
          type: string
          required: true
          description: Chat session ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: continue-chat
        method: POST
        description: Continue an existing chat session with a follow-up message
        inputParameters:
        - name: chatId
          in: path
          type: string
          required: true
          description: Chat session ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            message: '{{tools.message}}'
  exposes:
  - type: rest
    port: 8080
    namespace: vercel-ai-dev-api
    description: Unified REST API for AI-powered app development on Vercel.
    resources:
    - path: /v1/models
      name: models
      description: AI models available via Vercel AI Gateway
      operations:
      - method: GET
        name: list-models
        description: List all AI models available across providers
        call: vercel-ai-gateway.list-models
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/completions
      name: completions
      description: AI chat completions via unified gateway
      operations:
      - method: POST
        name: create-completion
        description: Create a chat completion using any model
        call: vercel-ai-gateway.create-chat-completion
        with:
          model: rest.model
          messages: rest.messages
          temperature: rest.temperature
          max_tokens: rest.max_tokens
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/embeddings
      name: embeddings
      description: Text embeddings for semantic search
      operations:
      - method: POST
        name: create-embedding
        description: Create text embeddings
        call: vercel-ai-gateway.create-embedding
        with:
          model: rest.model
          input: rest.input
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/apps
      name: apps
      description: AI-generated web applications via v0
      operations:
      - method: POST
        name: generate-app
        description: Generate a full-stack web app from a prompt
        call: vercel-v0.create-chat
        with:
          message: rest.message
          system: rest.system
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/apps/{chatId}
      name: app-by-id
      description: Manage generated applications
      operations:
      - method: GET
        name: get-app
        description: Get generated app code and preview
        call: vercel-v0.get-chat
        with:
          chatId: rest.chatId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: iterate-app
        description: Iterate on a generated app with follow-up instructions
        call: vercel-v0.continue-chat
        with:
          chatId: rest.chatId
          message: rest.message
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: vercel-ai-dev-mcp
    transport: http
    description: MCP server for AI-assisted web development on the Vercel platform.
    tools:
    - name: list-ai-models
      description: List all AI models available via the Vercel AI Gateway (Anthropic, OpenAI, Google, Meta, Mistral, and more)
      hints:
        readOnly: true
        idempotent: true
      call: vercel-ai-gateway.list-models
      outputParameters:
      - type: object
        mapping: $.
    - name: chat-with-model
      description: Send a chat completion request to any AI model via the Vercel AI Gateway
      hints:
        readOnly: true
        openWorld: true
      call: vercel-ai-gateway.create-chat-completion
      with:
        model: tools.model
        messages: tools.messages
        temperature: tools.temperature
        max_tokens: tools.max_tokens
      outputParameters:
      - type: object
        mapping: $.
    - name: create-embedding
      description: Create text embeddings for semantic search or retrieval using any embedding model
      hints:
        readOnly: true
        idempotent: true
      call: vercel-ai-gateway.create-embedding
      with:
        model: tools.model
        input: tools.input
      outputParameters:
      - type: object
        mapping: $.
    - name: generate-web-app
      description: Generate a full-stack Next.js web application from a natural language description using v0
      hints:
        readOnly: false
        idempotent: false
      call: vercel-v0.create-chat
      with:
        message: tools.message
        system: tools.system
      outputParameters:
      - type: object
        mapping: $.
    - name: get-generated-app
      description: Get the code files and preview URL for a v0 generated application
      hints:
        readOnly: true
        idempotent: true
      call: vercel-v0.get-chat
      with:
        chatId: tools.chatId
      outputParameters:
      - type: object
        mapping: $.
    - name: iterate-web-app
      description: Refine a v0 generated application with follow-up instructions (e.g., add dark mode, fix responsive layout,
        add authentication)
      hints:
        readOnly: false
        idempotent: false
      call: vercel-v0.continue-chat
      with:
        chatId: tools.chatId
        message: tools.message
      outputParameters:
      - type: object
        mapping: $.