Neighbortunes API

naftiko: 1.0.0-alpha2
info:
  label: Neighbortunes API
  description: The unofficial Neighbortunes API provides access to setlists, shows, songs, venues, jamcharts, albums, metadata,
    links, uploads, and band appearances. No authentication is required.
  tags:
  - Neighbortunes
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: neighbortunes
    baseUri: https://neighbortunes.net/api/v2
    description: Neighbortunes API HTTP API.
    resources:
    - name: setlists-format
      path: /setlists.{format}
      operations:
      - name: listsetlists
        method: GET
        description: List setlists
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: setlists-id-format
      path: /setlists/{id}.{format}
      operations:
      - name: getsetlist
        method: GET
        description: Get a setlist by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: setlists-column-value-format
      path: /setlists/{column}/{value}.{format}
      operations:
      - name: querysetlists
        method: GET
        description: Query setlists by column value
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: latest-format
      path: /latest.{format}
      operations:
      - name: listlatest
        method: GET
        description: Latest entries
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: shows-format
      path: /shows.{format}
      operations:
      - name: listshows
        method: GET
        description: List shows
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: shows-id-format
      path: /shows/{id}.{format}
      operations:
      - name: getshow
        method: GET
        description: Get a show by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: songs-format
      path: /songs.{format}
      operations:
      - name: listsongs
        method: GET
        description: List songs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: songs-id-format
      path: /songs/{id}.{format}
      operations:
      - name: getsong
        method: GET
        description: Get a song by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: venues-format
      path: /venues.{format}
      operations:
      - name: listvenues
        method: GET
        description: List venues
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: venues-id-format
      path: /venues/{id}.{format}
      operations:
      - name: getvenue
        method: GET
        description: Get a venue by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: jamcharts-format
      path: /jamcharts.{format}
      operations:
      - name: listjamcharts
        method: GET
        description: List jamcharts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: albums-format
      path: /albums.{format}
      operations:
      - name: listalbums
        method: GET
        description: List albums
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metadata-format
      path: /metadata.{format}
      operations:
      - name: listmetadata
        method: GET
        description: List metadata
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: links-format
      path: /links.{format}
      operations:
      - name: listlinks
        method: GET
        description: List links
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: uploads-format
      path: /uploads.{format}
      operations:
      - name: listuploads
        method: GET
        description: List uploads
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: appearances-format
      path: /appearances.{format}
      operations:
      - name: listappearances
        method: GET
        description: List appearances
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: list-column-format
      path: /list/{column}.{format}
      operations:
      - name: listcolumn
        method: GET
        description: List unique values for a column
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: neighbortunes-rest
    description: REST adapter for Neighbortunes API.
    resources:
    - path: /setlists.{format}
      name: listsetlists
      operations:
      - method: GET
        name: listsetlists
        description: List setlists
        call: neighbortunes.listsetlists
        outputParameters:
        - type: object
          mapping: $.
    - path: /setlists/{id}.{format}
      name: getsetlist
      operations:
      - method: GET
        name: getsetlist
        description: Get a setlist by ID
        call: neighbortunes.getsetlist
        outputParameters:
        - type: object
          mapping: $.
    - path: /setlists/{column}/{value}.{format}
      name: querysetlists
      operations:
      - method: GET
        name: querysetlists
        description: Query setlists by column value
        call: neighbortunes.querysetlists
        outputParameters:
        - type: object
          mapping: $.
    - path: /latest.{format}
      name: listlatest
      operations:
      - method: GET
        name: listlatest
        description: Latest entries
        call: neighbortunes.listlatest
        outputParameters:
        - type: object
          mapping: $.
    - path: /shows.{format}
      name: listshows
      operations:
      - method: GET
        name: listshows
        description: List shows
        call: neighbortunes.listshows
        outputParameters:
        - type: object
          mapping: $.
    - path: /shows/{id}.{format}
      name: getshow
      operations:
      - method: GET
        name: getshow
        description: Get a show by ID
        call: neighbortunes.getshow
        outputParameters:
        - type: object
          mapping: $.
    - path: /songs.{format}
      name: listsongs
      operations:
      - method: GET
        name: listsongs
        description: List songs
        call: neighbortunes.listsongs
        outputParameters:
        - type: object
          mapping: $.
    - path: /songs/{id}.{format}
      name: getsong
      operations:
      - method: GET
        name: getsong
        description: Get a song by ID
        call: neighbortunes.getsong
        outputParameters:
        - type: object
          mapping: $.
    - path: /venues.{format}
      name: listvenues
      operations:
      - method: GET
        name: listvenues
        description: List venues
        call: neighbortunes.listvenues
        outputParameters:
        - type: object
          mapping: $.
    - path: /venues/{id}.{format}
      name: getvenue
      operations:
      - method: GET
        name: getvenue
        description: Get a venue by ID
        call: neighbortunes.getvenue
        outputParameters:
        - type: object
          mapping: $.
    - path: /jamcharts.{format}
      name: listjamcharts
      operations:
      - method: GET
        name: listjamcharts
        description: List jamcharts
        call: neighbortunes.listjamcharts
        outputParameters:
        - type: object
          mapping: $.
    - path: /albums.{format}
      name: listalbums
      operations:
      - method: GET
        name: listalbums
        description: List albums
        call: neighbortunes.listalbums
        outputParameters:
        - type: object
          mapping: $.
    - path: /metadata.{format}
      name: listmetadata
      operations:
      - method: GET
        name: listmetadata
        description: List metadata
        call: neighbortunes.listmetadata
        outputParameters:
        - type: object
          mapping: $.
    - path: /links.{format}
      name: listlinks
      operations:
      - method: GET
        name: listlinks
        description: List links
        call: neighbortunes.listlinks
        outputParameters:
        - type: object
          mapping: $.
    - path: /uploads.{format}
      name: listuploads
      operations:
      - method: GET
        name: listuploads
        description: List uploads
        call: neighbortunes.listuploads
        outputParameters:
        - type: object
          mapping: $.
    - path: /appearances.{format}
      name: listappearances
      operations:
      - method: GET
        name: listappearances
        description: List appearances
        call: neighbortunes.listappearances
        outputParameters:
        - type: object
          mapping: $.
    - path: /list/{column}.{format}
      name: listcolumn
      operations:
      - method: GET
        name: listcolumn
        description: List unique values for a column
        call: neighbortunes.listcolumn
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: neighbortunes-mcp
    transport: http
    description: MCP adapter for Neighbortunes API for AI agent use.
    tools:
    - name: listsetlists
      description: List setlists
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listsetlists
      outputParameters:
      - type: object
        mapping: $.
    - name: getsetlist
      description: Get a setlist by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.getsetlist
      outputParameters:
      - type: object
        mapping: $.
    - name: querysetlists
      description: Query setlists by column value
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.querysetlists
      outputParameters:
      - type: object
        mapping: $.
    - name: listlatest
      description: Latest entries
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listlatest
      outputParameters:
      - type: object
        mapping: $.
    - name: listshows
      description: List shows
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listshows
      outputParameters:
      - type: object
        mapping: $.
    - name: getshow
      description: Get a show by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.getshow
      outputParameters:
      - type: object
        mapping: $.
    - name: listsongs
      description: List songs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listsongs
      outputParameters:
      - type: object
        mapping: $.
    - name: getsong
      description: Get a song by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.getsong
      outputParameters:
      - type: object
        mapping: $.
    - name: listvenues
      description: List venues
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listvenues
      outputParameters:
      - type: object
        mapping: $.
    - name: getvenue
      description: Get a venue by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.getvenue
      outputParameters:
      - type: object
        mapping: $.
    - name: listjamcharts
      description: List jamcharts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listjamcharts
      outputParameters:
      - type: object
        mapping: $.
    - name: listalbums
      description: List albums
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listalbums
      outputParameters:
      - type: object
        mapping: $.
    - name: listmetadata
      description: List metadata
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listmetadata
      outputParameters:
      - type: object
        mapping: $.
    - name: listlinks
      description: List links
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listlinks
      outputParameters:
      - type: object
        mapping: $.
    - name: listuploads
      description: List uploads
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listuploads
      outputParameters:
      - type: object
        mapping: $.
    - name: listappearances
      description: List appearances
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listappearances
      outputParameters:
      - type: object
        mapping: $.
    - name: listcolumn
      description: List unique values for a column
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: neighbortunes.listcolumn
      outputParameters:
      - type: object
        mapping: $.