naftiko: 1.0.0-alpha2
info:
  label: Reddit Community Engagement
  description: Unified capability for reading and engaging with Reddit community content. Combines the Reddit Data API for
    browsing posts, searching communities, and accessing user profiles. Used by community managers, content researchers, and
    social listening applications to monitor discussions, analyze sentiment, and engage with Reddit audiences.
  tags:
  - Communities
  - Content
  - Reddit
  - Social Media
  - Social Listening
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    REDDIT_ACCESS_TOKEN: REDDIT_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: reddit-data
    baseUri: https://oauth.reddit.com
    description: Reddit Data API for accessing platform content and communities
    authentication:
      type: bearer
      token: '{{REDDIT_ACCESS_TOKEN}}'
    resources:
    - name: me
      path: /api/v1/me
      description: Current user identity and profile
      operations:
      - name: get-me
        method: GET
        description: Get current authenticated user identity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: hot-listings
      path: /r/{subreddit}/hot
      description: Hot post listings for a subreddit
      operations:
      - name: get-hot-listings
        method: GET
        description: Get hot posts from a subreddit
        inputParameters:
        - name: subreddit
          in: path
          type: string
          required: true
          description: Subreddit name
        - name: limit
          in: query
          type: integer
          required: false
          description: Number of posts to return (max 100)
        - name: after
          in: query
          type: string
          required: false
          description: Pagination cursor
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: new-listings
      path: /r/{subreddit}/new
      description: New post listings for a subreddit
      operations:
      - name: get-new-listings
        method: GET
        description: Get newest posts from a subreddit
        inputParameters:
        - name: subreddit
          in: path
          type: string
          required: true
          description: Subreddit name
        - name: limit
          in: query
          type: integer
          required: false
          description: Number of posts to return
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: subreddit-info
      path: /r/{subreddit}/about
      description: Subreddit community information
      operations:
      - name: get-subreddit-info
        method: GET
        description: Get subreddit metadata and configuration
        inputParameters:
        - name: subreddit
          in: path
          type: string
          required: true
          description: Subreddit name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: search
      path: /search
      description: Reddit search
      operations:
      - name: search-submissions
        method: GET
        description: Search Reddit submissions
        inputParameters:
        - name: q
          in: query
          type: string
          required: true
          description: Search query
        - name: sort
          in: query
          type: string
          required: false
          description: Sort order (relevance, hot, top, new)
        - name: limit
          in: query
          type: integer
          required: false
          description: Number of results
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: submit
      path: /api/submit
      description: Post submission
      operations:
      - name: submit-post
        method: POST
        description: Submit a new post to a subreddit
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: form
          data:
            sr: '{{tools.subreddit}}'
            title: '{{tools.title}}'
            text: '{{tools.text}}'
            kind: self
  exposes:
  - type: rest
    port: 8080
    namespace: reddit-community-rest
    description: Unified REST API for Reddit community content access and engagement.
    resources:
    - path: /v1/me
      name: me
      description: Current user identity
      operations:
      - method: GET
        name: get-me
        description: Get authenticated user identity
        call: reddit-data.get-me
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subreddits/{subreddit}
      name: subreddit
      description: Subreddit community information
      operations:
      - method: GET
        name: get-subreddit
        description: Get subreddit information and stats
        call: reddit-data.get-subreddit-info
        with:
          subreddit: rest.subreddit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subreddits/{subreddit}/hot
      name: hot-posts
      description: Hot posts in a subreddit
      operations:
      - method: GET
        name: get-hot-posts
        description: Get trending hot posts
        call: reddit-data.get-hot-listings
        with:
          subreddit: rest.subreddit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/subreddits/{subreddit}/new
      name: new-posts
      description: New posts in a subreddit
      operations:
      - method: GET
        name: get-new-posts
        description: Get newest posts
        call: reddit-data.get-new-listings
        with:
          subreddit: rest.subreddit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/search
      name: search
      description: Reddit search
      operations:
      - method: GET
        name: search
        description: Search Reddit content
        call: reddit-data.search-submissions
        with:
          q: rest.q
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/posts
      name: posts
      description: Post submission
      operations:
      - method: POST
        name: submit-post
        description: Submit a new post to a subreddit
        call: reddit-data.submit-post
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9080
    namespace: reddit-community-mcp
    transport: http
    description: MCP server for AI-assisted Reddit community monitoring and engagement.
    tools:
    - name: get-current-user
      description: Get the identity of the currently authenticated Reddit user
      hints:
        readOnly: true
        openWorld: false
      call: reddit-data.get-me
      outputParameters:
      - type: object
        mapping: $.
    - name: get-subreddit-info
      description: Get metadata, description, subscriber count, and stats for a subreddit
      hints:
        readOnly: true
        openWorld: true
      call: reddit-data.get-subreddit-info
      with:
        subreddit: tools.subreddit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-hot-posts
      description: Get the currently trending hot posts from a subreddit
      hints:
        readOnly: true
        openWorld: true
      call: reddit-data.get-hot-listings
      with:
        subreddit: tools.subreddit
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-new-posts
      description: Get the most recently submitted posts from a subreddit
      hints:
        readOnly: true
        openWorld: true
      call: reddit-data.get-new-listings
      with:
        subreddit: tools.subreddit
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: search-reddit
      description: Search Reddit for posts and discussions matching a query
      hints:
        readOnly: true
        openWorld: true
      call: reddit-data.search-submissions
      with:
        q: tools.query
        sort: tools.sort
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: submit-post
      description: Submit a new text post to a subreddit
      hints:
        readOnly: false
        openWorld: false
      call: reddit-data.submit-post
      with:
        subreddit: tools.subreddit
        title: tools.title
        text: tools.text
      outputParameters:
      - type: object
        mapping: $.