bundleup-sdk 0.2.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 979b84801f81102d120f0a9936fda8d851ee68551017d1a7876dbe0530024601
-  data.tar.gz: c1c5a77941501aa6d2c49c11f5f1906462bfd6b9d376f080a87b1d22f9131ba9
+  metadata.gz: 3ece90ca061e8b5bbac827ca07dcc35b1c029e235d27ec319cef3117cd0652d0
+  data.tar.gz: 034fdb9a5ccf8c36aa38a3d8a7870f8c32a7997ff617cfed395fd4e0ff03aaae
 SHA512:
-  metadata.gz: 7d936f5585a32fa86e47e841033cc70e01d7abd314ded883ad6586e248f71744f04de434fa8442b6adcb36fe8d1070e7b500d543c3356452d781ae1e562f048a
-  data.tar.gz: d990e1de94e7f89c0cf25ae2c6165c65a2db6d81a6d03017cc107a105dee96680a3cfcb227f3c4e565bf6ab731f861f56fdcb6f1766273412f0d029ac28fd790
+  metadata.gz: eb30ce08198acee62b5ec10469a4a116a8186eab6669fbc1bcaece16899911ca50f5b37a1bc15d6dcc096a87b6c160faa3ea2319c8ce552159aa4347be869b85
+  data.tar.gz: 38855ea19f0662f62acbddc68e0b439f4171dadf5bba56f29b4dde40c4cfc14f72cf6da871af0faa9039b6a37c5b3188a968bacd3abcb859468053913bd2efe6

data/README.md

@@ -24,7 +24,6 @@ Official Ruby SDK for the [BundleUp](https://bundleup.io) API. Connect to 100+ i
 - [Development](#development)
 - [Contributing](#contributing)
 - [License](#license)
-- [Support](#support)
 
 ## Installation
 
@@ -84,7 +83,7 @@ Runnable examples are available in the [`examples/`](./examples) directory:
 
 - [`examples/basic_usage.rb`](./examples/basic_usage.rb) - Client setup, connections, integrations, and webhooks
 - [`examples/proxy_api.rb`](./examples/proxy_api.rb) - Proxy API GET request with a connection
-- [`examples/unify_api.rb`](./examples/unify_api.rb) - Unify Chat, Git, and PM endpoint usage
+- [`examples/unify_api.rb`](./examples/unify_api.rb) - Unify Chat, Git, PM, Ticketing, and Drive endpoint usage
 - [`examples/README.md`](./examples/README.md) - Setup and execution instructions
 
 ## Quick Start
@@ -641,6 +640,43 @@ unify = client.unify('conn_123abc')
 
 The Chat API provides a unified interface for chat platforms like Slack, Discord, and Microsoft Teams.
 
+##### List Users
+
+Retrieve a list of users from the connected chat platform.
+
+```ruby
+result = unify.chat.users(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Users: #{result['data']}"
+puts "Next cursor: #{result['metadata']['next']}"
+```
+
+**Parameters:**
+
+- `limit` (Integer, optional): Maximum number of users to return (default: 100, max: 1000)
+- `after` (String, optional): Pagination cursor from previous response
+- `include_raw` (Boolean, optional): Include raw API response from the integration (default: false)
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => 'U1234567890',
+      'name' => 'Jane Doe'
+    }
+  ],
+  'metadata' => {
+    'next' => 'cursor_abc123'
+  }
+}
+```
+
 ##### List Channels
 
 Retrieve a list of channels from the connected chat platform.
@@ -701,6 +737,31 @@ end
 puts "Fetched #{all_channels.length} total channels"
 ```
 
+##### Send Message
+
+Send a message to a channel on the connected chat platform.
+
+```ruby
+result = unify.chat.message('C1234567890', 'Hello from BundleUp! :wave:')
+
+puts "Message sent: #{result['data']}"
+```
+
+**Parameters:**
+
+- `channel_id` (String, required): The ID of the channel to send the message to
+- `text` (String, required): Markdown-formatted message text
+
+**Response:**
+
+```ruby
+{
+  'data' => {
+    # Raw response data from the chat provider
+  }
+}
+```
+
 #### Git API
 
 The Git API provides a unified interface for version control platforms like GitHub, GitLab, and Bitbucket.
@@ -841,20 +902,45 @@ puts "Releases: #{result['data']}"
 }
 ```
 
-#### Project Management API
+##### List Branches
 
-The PM API provides a unified interface for project management platforms like Jira, Linear, and Asana.
+```ruby
+result = unify.git.branches('organization/repo-name', limit: 50)
 
-##### List Issues
+puts "Branches: #{result['data']}"
+```
+
+**Response:**
 
 ```ruby
-result = unify.pm.issues(
+{
+  'data' => [
+    {
+      'name' => 'main',
+      'commit_sha' => 'abc123def456',
+      'protected' => true
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
+```
+
+#### Ticketing API
+
+The Ticketing API provides a unified interface for ticketing and project management platforms like Jira, Linear, and Asana.
+
+##### List Tickets
+
+```ruby
+result = unify.ticketing.tickets(
   limit: 100,
   after: nil,
   include_raw: false
 )
 
-puts "Issues: #{result['data']}"
+puts "Tickets: #{result['data']}"
 ```
 
 **Response:**
@@ -881,8 +967,108 @@ puts "Issues: #{result['data']}"
 **Filtering and sorting:**
 
 ```ruby
-open_issues = result['data'].select { |issue| issue['status'] == 'open' }
-sorted_by_date = result['data'].sort_by { |issue| Time.parse(issue['created_at']) }.reverse
+open_tickets = result['data'].select { |ticket| ticket['status'] == 'open' }
+sorted_by_date = result['data'].sort_by { |ticket| Time.parse(ticket['created_at']) }.reverse
+```
+
+#### CRM API
+
+The CRM API provides a unified interface for CRM platforms like Attio, HubSpot, PipeDrive, Salesforce and Zoho.
+
+##### List Companies
+
+```ruby
+result = unify.crm.companies(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Companies: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => '12345',
+      'name' => 'Acme Inc.',
+      'website' => 'https://acme.example.com'
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
+```
+
+##### List Contacts
+
+```ruby
+result = unify.crm.contacts(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Contacts: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => '67890',
+      'name' => 'Jane Doe',
+      'email' => 'jane@acme.example.com'
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
+```
+
+#### Drive API
+
+The Drive API provides a unified interface for file storage platforms like Google Drive, OneDrive, Box, Dropbox and Microsoft SharePoint.
+
+##### List Files
+
+```ruby
+result = unify.drive.files(
+  limit: 100,
+  after: nil,
+  include_raw: false
+)
+
+puts "Files: #{result['data']}"
+```
+
+**Response:**
+
+```ruby
+{
+  'data' => [
+    {
+      'id' => 'file_123',
+      'name' => 'quarterly-report.pdf',
+      'mime_type' => 'application/pdf',
+      'size' => 204800,
+      'created_at' => '2024-01-15T10:30:00Z',
+      'updated_at' => '2024-01-20T14:22:00Z',
+      'url' => 'https://drive.example.com/file_123',
+      'is_folder' => false
+    }
+  ],
+  'metadata' => {
+    'next' => nil
+  }
+}
 ```
 
 ## Error Handling
@@ -938,10 +1124,22 @@ lib/
 │       ├── base.rb          # Base Unify class
 │       ├── chat.rb          # Chat Unify API
 │       ├── git.rb           # Git Unify API
-│       └── pm.rb            # PM Unify API
+│       ├── ticketing.rb     # Ticketing Unify API
+│       ├── crm.rb           # CRM Unify API
+│       └── drive.rb         # Drive Unify API
+sig/                         # RBS type signatures (mirrors lib/)
 spec/                        # Test files
 ```
 
+### Type Signatures
+
+The gem ships [RBS](https://github.com/ruby/rbs) signatures for the Unify API under `sig/bundleup/unify/`. They're optional at runtime (deleting `sig/` doesn't change behavior) but give editors and `rbs` itself static types for `unify.chat.channels`, `unify.git.repos`, and so on.
+
+```bash
+# Validate the signature files
+bundle exec rake sig
+```
+
 ### Running Tests
 
 ```bash
@@ -1050,39 +1248,6 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## Support
-
-Need help? We're here for you!
-
-### Documentation
-
-- **Official Docs**: [https://docs.bundleup.io](https://docs.bundleup.io)
-- **API Reference**: [https://docs.bundleup.io/api](https://docs.bundleup.io/api)
-- **SDK Guides**: [https://docs.bundleup.io/sdk/ruby](https://docs.bundleup.io/sdk/ruby)
-
-### Community
-
-- **Discord**: [https://discord.gg/bundleup](https://discord.gg/bundleup)
-- **GitHub Discussions**: [https://github.com/bundleup/bundleup-sdk-ruby/discussions](https://github.com/bundleup/bundleup-sdk-ruby/discussions)
-- **Stack Overflow**: Tag your questions with `bundleup`
-
-### Direct Support
-
-- **Email**: [support@bundleup.io](mailto:support@bundleup.io)
-- **GitHub Issues**: [https://github.com/bundleup/bundleup-sdk-ruby/issues](https://github.com/bundleup/bundleup-sdk-ruby/issues)
-- **Twitter**: [@bundleup_io](https://twitter.com/bundleup_io)
-
-### Enterprise Support
-
-For enterprise customers, we offer:
-
-- Priority support with SLA
-- Dedicated support channel
-- Architecture consultation
-- Custom integration assistance
-
-Contact [enterprise@bundleup.io](mailto:enterprise@bundleup.io) for more information.
-
 ## Code of Conduct
 
 Everyone interacting in the BundleUp project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/bundleup/bundleup-sdk-ruby/blob/main/CODE_OF_CONDUCT).

data/lib/bundleup/client.rb

@@ -38,5 +38,13 @@ module BundleUp
 
       BundleUp::Unify::Client.new(@api_key, connection_id)
     end
+
+    def mcp(connection_id)
+      if connection_id.nil? || connection_id.empty?
+        raise ArgumentError, 'Connection ID is required to create an MCP instance.'
+      end
+
+      BundleUp::MCP.new(@api_key, connection_id)
+    end
   end
 end

data/lib/bundleup/mcp.rb

@@ -0,0 +1,267 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module BundleUp
+  # Transport for a connection's MCP server.
+  #
+  # +post+ and +delete+ return the raw Faraday response, the way Proxy does.
+  # Use +connect+ for a managed session that handles the handshake and
+  # response decoding.
+  class MCP
+    BASE_URL = 'https://mcp.bundleup.io'
+
+    # Separates the API key from an appended connection ID. Safe to split on:
+    # API keys are alphanumeric and connection IDs are cuids.
+    CREDENTIAL_SEPARATOR = '.'
+
+    attr_reader :api_key, :connection_id
+
+    def initialize(api_key, connection_id)
+      @api_key = api_key
+      @connection_id = connection_id
+    end
+
+    # The URL and headers for an MCP client running in your own process.
+    def transport
+      { url: BASE_URL, headers: default_headers }
+    end
+
+    # The URL and a single bearer token carrying both the API key and the
+    # connection, for model-hosted MCP clients that cannot set custom headers.
+    # Note this hands your API key to the model provider.
+    def hosted
+      { url: BASE_URL, token: "#{@api_key}#{CREDENTIAL_SEPARATOR}#{@connection_id}" }
+    end
+
+    # Send a JSON-RPC message and return the raw response. Pass
+    # +Mcp-Session-Id+ in +headers+ to stay on an existing session.
+    def post(body, headers: {})
+      payload = body.is_a?(String) ? body : body.to_json
+
+      connection.post(BASE_URL, payload, default_headers.merge(headers))
+    end
+
+    # End an MCP session. Pass the session's +Mcp-Session-Id+ in +headers+.
+    def delete(headers: {})
+      connection.delete(BASE_URL, nil, default_headers.merge(headers))
+    end
+
+    # Open a managed MCP session for this connection.
+    def connect
+      MCPClient.new(BASE_URL, @api_key, @connection_id)
+    end
+
+    private
+
+    def default_headers
+      {
+        'Authorization' => "Bearer #{@api_key}",
+        'Content-Type' => 'application/json',
+        'Accept' => 'application/json, text/event-stream',
+        'BU-Connection-Id' => @connection_id
+      }
+    end
+
+    def connection
+      @connection ||= Faraday.new { |faraday| faraday.adapter Faraday.default_adapter }
+    end
+  end
+
+  # A connected MCP session.
+  #
+  # Tools, resources and prompts are defined by the provider — BundleUp does
+  # not rename or normalize them.
+  class MCPClient
+    PROTOCOL_VERSION = '2025-06-18'
+    CLIENT_NAME = 'bundleup-sdk'
+
+    def initialize(base_url, api_key, connection_id)
+      @base_url = base_url
+      @api_key = api_key
+      @connection_id = connection_id
+      @session_id = nil
+      @connected = false
+      @last_id = 0
+    end
+
+    # List the provider's tools, following pagination to the end.
+    def tools
+      paginate('tools/list', 'tools')
+    end
+
+    # Call a tool by name, with arguments matching its own input schema.
+    def tool(name, args = {})
+      raise ArgumentError, 'Tool name is required to call a tool.' if blank?(name)
+
+      connect
+      send_message('tools/call', { name: name, arguments: args })
+    end
+
+    # List the provider's resources, following pagination to the end.
+    def resources
+      paginate('resources/list', 'resources')
+    end
+
+    # Read a resource by URI.
+    def resource(uri)
+      raise ArgumentError, 'Resource URI is required to read a resource.' if blank?(uri)
+
+      connect
+      send_message('resources/read', { uri: uri })
+    end
+
+    # List the provider's prompts, following pagination to the end.
+    def prompts
+      paginate('prompts/list', 'prompts')
+    end
+
+    # Get a prompt by name.
+    def prompt(name, args = {})
+      raise ArgumentError, 'Prompt name is required to get a prompt.' if blank?(name)
+
+      connect
+      send_message('prompts/get', { name: name, arguments: args })
+    end
+
+    # Send any other JSON-RPC method on this session.
+    def request(method, params = nil)
+      raise ArgumentError, 'Method is required to send a request.' if blank?(method)
+
+      connect
+      send_message(method, params)
+    end
+
+    # End the session and reset local state.
+    def close
+      delete_session if @session_id
+
+      @session_id = nil
+      @connected = false
+      nil
+    end
+
+    private
+
+    def blank?(value)
+      value.nil? || value.to_s.empty?
+    end
+
+    def default_headers
+      headers = {
+        'Authorization' => "Bearer #{@api_key}",
+        'Content-Type' => 'application/json',
+        'Accept' => 'application/json, text/event-stream',
+        'BU-Connection-Id' => @connection_id
+      }
+      headers['Mcp-Session-Id'] = @session_id if @session_id
+      headers
+    end
+
+    def connection
+      @connection ||= Faraday.new { |faraday| faraday.adapter Faraday.default_adapter }
+    end
+
+    def post_payload(payload)
+      response = connection.post(@base_url, payload.to_json, default_headers)
+      session_id = response.headers['mcp-session-id']
+      @session_id = session_id if session_id
+
+      raise error_for(response) unless response.success?
+
+      response
+    end
+
+    def error_for(response)
+      fallback = "MCP request failed with status #{response.status}."
+      parsed = JSON.parse(response.body.to_s)
+      return RuntimeError.new(fallback) unless parsed.is_a?(Hash) && parsed['message']
+
+      code = parsed['code']
+      RuntimeError.new(code ? "#{parsed['message']} (#{code})" : parsed['message'])
+    rescue JSON::ParserError
+      RuntimeError.new(fallback)
+    end
+
+    # Run the MCP handshake, once. Deferred until the first call.
+    def connect
+      return if @connected
+
+      send_message('initialize', handshake_params)
+      post_payload({ jsonrpc: '2.0', method: 'notifications/initialized' })
+      @connected = true
+    end
+
+    def handshake_params
+      {
+        protocolVersion: PROTOCOL_VERSION,
+        capabilities: {},
+        clientInfo: { name: CLIENT_NAME, version: BundleUp::VERSION }
+      }
+    end
+
+    def send_message(method, params = nil)
+      @last_id += 1
+      payload = { jsonrpc: '2.0', id: @last_id, method: method }
+      payload[:params] = params unless params.nil?
+
+      message = parse(post_payload(payload), @last_id)
+      raise "No response received for #{method}." if message.nil?
+      raise message['error']['message'].to_s if message['error']
+
+      message['result'] || {}
+    end
+
+    # Providers may answer a plain request/response over text/event-stream.
+    def parse(response, message_id)
+      body = response.body.to_s
+      return nil if body.empty?
+
+      content_type = response.headers['content-type'].to_s
+      return JSON.parse(body) unless content_type.include?('text/event-stream')
+
+      parse_stream(body, message_id)
+    end
+
+    def parse_stream(body, message_id)
+      body.gsub("\r\n", "\n").split("\n\n").each do |event|
+        data = event_data(event)
+        next if data.empty?
+
+        message = JSON.parse(data)
+        # Skip server notifications interleaved on the stream.
+        return message if message.is_a?(Hash) && message['id'] == message_id
+      end
+
+      nil
+    end
+
+    def event_data(event)
+      event.split("\n")
+           .select { |line| line.start_with?('data:') }
+           .map { |line| line.sub('data:', '').strip }
+           .join("\n")
+    end
+
+    def paginate(method, key)
+      connect
+      items = []
+      cursor = nil
+
+      loop do
+        result = send_message(method, cursor ? { cursor: cursor } : nil)
+        items.concat(result[key] || [])
+        cursor = result['nextCursor']
+        break unless cursor
+      end
+
+      items
+    end
+
+    def delete_session
+      connection.delete(@base_url, nil, default_headers)
+    rescue Faraday::Error
+      nil
+    end
+  end
+end

data/lib/bundleup/unify/chat.rb

@@ -4,6 +4,17 @@ module BundleUp
   module Unify
     # Client for chat-related Unify endpoints.
     class Chat < Base
+      # Fetches users from the connected chat provider.
+      def users(params = {})
+        response = connection.get('chat/users') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch chat/users: #{response.status}" unless response.success?
+
+        response.body
+      end
+
       # Fetches channels from the connected chat provider.
       def channels(params = {})
         response = connection.get('chat/channels') do |req|
@@ -14,6 +25,19 @@ module BundleUp
 
         response.body
       end
+
+      # Sends a message to a channel on the connected chat provider.
+      def message(channel_id, text)
+        raise ArgumentError, 'channel_id is required to send a message.' if channel_id.nil?
+
+        encoded_channel_id = URI.encode_www_form_component(channel_id)
+
+        response = connection.post("chat/channels/#{encoded_channel_id}/message", { text: text }.to_json)
+
+        raise "Failed to post chat/channels/#{encoded_channel_id}/message: #{response.status}" unless response.success?
+
+        response.body
+      end
     end
   end
 end

data/lib/bundleup/unify/crm.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for CRM-related Unify endpoints.
+    class CRM < Base
+      # Fetches companies from the connected CRM provider.
+      def companies(params = {})
+        response = connection.get('crm/companies') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch crm/companies: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      # Fetches contacts from the connected CRM provider.
+      def contacts(params = {})
+        response = connection.get('crm/contacts') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch crm/contacts: #{response.status}" unless response.success?
+
+        response.body
+      end
+    end
+  end
+end

data/lib/bundleup/unify/drive.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for Drive-related Unify endpoints.
+    class Drive < Base
+      # Fetches files from the connected Drive provider.
+      def files(params = {})
+        response = connection.get('drive/files') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch drive/files: #{response.status}" unless response.success?
+
+        response.body
+      end
+    end
+  end
+end

data/lib/bundleup/unify/git.rb

@@ -17,6 +17,8 @@ module BundleUp
 
       # Fetches pull requests for a specific repository from the connected Git provider.
       def pulls(repo_name, params = {})
+        raise ArgumentError, 'repo_name is required to fetch pulls.' if blank?(repo_name)
+
         encoded_repo_name = URI.encode_www_form_component(repo_name)
 
         response = connection.get("git/repos/#{encoded_repo_name}/pulls") do |req|
@@ -30,6 +32,8 @@ module BundleUp
 
       # Fetches tags for a specific repository from the connected Git provider.
       def tags(repo_name, params = {})
+        raise ArgumentError, 'repo_name is required to fetch tags.' if blank?(repo_name)
+
         encoded_repo_name = URI.encode_www_form_component(repo_name)
 
         response = connection.get("git/repos/#{encoded_repo_name}/tags") do |req|
@@ -43,6 +47,8 @@ module BundleUp
 
       # Fetches releases for a specific repository from the connected Git provider.
       def releases(repo_name, params = {})
+        raise ArgumentError, 'repo_name is required to fetch releases.' if blank?(repo_name)
+
         encoded_repo_name = URI.encode_www_form_component(repo_name)
 
         response = connection.get("git/repos/#{encoded_repo_name}/releases") do |req|
@@ -53,6 +59,42 @@ module BundleUp
 
         response.body
       end
+
+      # Fetches branches for a specific repository from the connected Git provider.
+      def branches(repo_name, params = {})
+        raise ArgumentError, 'repo_name is required to fetch branches.' if blank?(repo_name)
+
+        encoded_repo_name = URI.encode_www_form_component(repo_name)
+
+        response = connection.get("git/repos/#{encoded_repo_name}/branches") do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch git/repos/#{encoded_repo_name}/branches: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      # Fetches commits for a specific repository from the connected Git provider.
+      def commits(repo_name, params = {})
+        raise ArgumentError, 'repo_name is required to fetch commits.' if blank?(repo_name)
+
+        encoded_repo_name = URI.encode_www_form_component(repo_name)
+
+        response = connection.get("git/repos/#{encoded_repo_name}/commits") do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch git/repos/#{encoded_repo_name}/commits: #{response.status}" unless response.success?
+
+        response.body
+      end
+
+      private
+
+      def blank?(value)
+        value.nil? || value.to_s.empty?
+      end
     end
   end
 end

data/lib/bundleup/unify/mcp.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # The Unified MCP server.
+    #
+    # Same protocol and headers as Proxy MCP, but the tools are BundleUp's
+    # normalized ones rather than the provider's. Tools only — Unified MCP
+    # exposes no resources or prompts.
+    #
+    # The server is stateless and POST-only, so there is no session to close.
+    class MCP
+      BASE_URL = 'https://unify.bundleup.io/v1/mcp'
+
+      attr_reader :api_key, :connection_id
+
+      def initialize(api_key, connection_id)
+        @api_key = api_key
+        @connection_id = connection_id
+        @client = ::BundleUp::MCPClient.new(BASE_URL, api_key, connection_id)
+      end
+
+      # The URL and a single bearer token carrying both the API key and the
+      # connection, for model-hosted MCP clients that cannot set headers.
+      def hosted
+        separator = ::BundleUp::MCP::CREDENTIAL_SEPARATOR
+
+        { url: BASE_URL, token: "#{@api_key}#{separator}#{@connection_id}" }
+      end
+
+      # List the available unified tools.
+      def tools
+        @client.tools
+      end
+
+      # Call a unified tool with optional arguments.
+      def tool(name, args = {})
+        raise ArgumentError, 'Tool name is required to call a tool.' if name.nil? || name.to_s.empty?
+
+        @client.tool(name, args)
+      end
+    end
+  end
+end

data/lib/bundleup/unify/ticketing.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module BundleUp
+  module Unify
+    # Client for ticketing Unify endpoints.
+    class Ticketing < Base
+      # Fetches tickets from the connected ticketing tool.
+      def tickets(params = {})
+        response = connection.get('ticketing/tickets') do |req|
+          req.params = params
+        end
+
+        raise "Failed to fetch ticketing/tickets: #{response.status}" unless response.success?
+
+        response.body
+      end
+    end
+  end
+end

data/lib/bundleup/unify.rb

@@ -7,9 +7,43 @@ module BundleUp
       attr_reader :api_key, :connection_id
 
       def initialize(api_key, connection_id)
-        @pm = BundleUp::Unify::PM.new(api_key, connection_id)
+        @ticketing = BundleUp::Unify::Ticketing.new(api_key, connection_id)
         @chat = BundleUp::Unify::Chat.new(api_key, connection_id)
         @git = BundleUp::Unify::Git.new(api_key, connection_id)
+        @crm = BundleUp::Unify::CRM.new(api_key, connection_id)
+        @drive = BundleUp::Unify::Drive.new(api_key, connection_id)
+        @api_key = api_key
+        @connection_id = connection_id
+      end
+
+      # Access the Chat API for the connection.
+      def chat
+        @chat ||= BundleUp::Unify::Chat.new(api_key, connection_id)
+      end
+
+      # Access the Git API for the connection.
+      def git
+        @git ||= BundleUp::Unify::Git.new(api_key, connection_id)
+      end
+
+      # Access the CRM API for the connection.
+      def crm
+        @crm ||= BundleUp::Unify::CRM.new(api_key, connection_id)
+      end
+
+      # Access the Ticketing API for the connection.
+      def ticketing
+        @ticketing ||= BundleUp::Unify::Ticketing.new(api_key, connection_id)
+      end
+
+      # Access the Drive API for the connection.
+      def drive
+        @drive ||= BundleUp::Unify::Drive.new(api_key, connection_id)
+      end
+
+      # Access the Unified MCP server for the connection.
+      def mcp
+        @mcp ||= BundleUp::Unify::MCP.new(api_key, connection_id)
       end
     end
   end

data/lib/bundleup/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BundleUp
-  VERSION = '0.2.2'
+  VERSION = '0.4.0'
 end

data/lib/bundleup.rb

@@ -6,6 +6,7 @@ require_relative 'bundleup/version'
 require_relative 'bundleup/client'
 require_relative 'bundleup/proxy'
 require_relative 'bundleup/unify'
+require_relative 'bundleup/mcp'
 
 # Resources
 require_relative 'bundleup/resources/base'
@@ -17,7 +18,10 @@ require_relative 'bundleup/resources/webhook'
 require_relative 'bundleup/unify/base'
 require_relative 'bundleup/unify/chat'
 require_relative 'bundleup/unify/git'
-require_relative 'bundleup/unify/pm'
+require_relative 'bundleup/unify/ticketing'
+require_relative 'bundleup/unify/crm'
+require_relative 'bundleup/unify/drive'
+require_relative 'bundleup/unify/mcp'
 
 # Main module for the BundleUp SDK.
 module BundleUp

data/sig/bundleup/unify/base.rbs

@@ -0,0 +1,17 @@
+module BundleUp
+  module Unify
+    class Base
+      BASE_URL: String
+      API_VERSION: String
+
+      attr_reader api_key: String
+      attr_reader connection_id: String
+
+      def initialize: (String api_key, String connection_id) -> void
+
+      private
+
+      def connection: () -> Faraday::Connection
+    end
+  end
+end

data/sig/bundleup/unify/chat.rbs

@@ -0,0 +1,13 @@
+module BundleUp
+  module Unify
+    class Chat < Base
+      type chat_user = { id: String, name: String }
+      type chat_channel = { id: String, name: String }
+      type metadata = { next: String? }
+
+      def users: (?Hash[Symbol, untyped] params) -> { data: Array[chat_user], metadata: metadata }
+      def channels: (?Hash[Symbol, untyped] params) -> { data: Array[chat_channel], metadata: metadata }
+      def message: (String channel_id, String text) -> { data: Hash[String, untyped] }
+    end
+  end
+end

data/sig/bundleup/unify/crm.rbs

@@ -0,0 +1,12 @@
+module BundleUp
+  module Unify
+    class CRM < Base
+      type crm_company = { id: String, name: String, website: String? }
+      type crm_contact = { id: String, name: String, email: String? }
+      type metadata = { next: String? }
+
+      def companies: (?Hash[Symbol, untyped] params) -> { data: Array[crm_company], metadata: metadata }
+      def contacts: (?Hash[Symbol, untyped] params) -> { data: Array[crm_contact], metadata: metadata }
+    end
+  end
+end

data/sig/bundleup/unify/drive.rbs

@@ -0,0 +1,20 @@
+module BundleUp
+  module Unify
+    class Drive < Base
+      type drive_file = {
+        id: String,
+        name: String,
+        mime_type: String?,
+        size: Integer?,
+        created_at: String?,
+        updated_at: String?,
+        url: String?,
+        is_folder: bool
+      }
+
+      type metadata = { next: String? }
+
+      def files: (?Hash[Symbol, untyped] params) -> { data: Array[drive_file], metadata: metadata }
+    end
+  end
+end

data/sig/bundleup/unify/git.rbs

@@ -0,0 +1,53 @@
+module BundleUp
+  module Unify
+    class Git < Base
+      type git_repo = {
+        id: Integer | String,
+        name: String,
+        full_name: String,
+        description: String?,
+        url: String,
+        created_at: String,
+        updated_at: String,
+        pushed_at: String
+      }
+
+      type git_pull = {
+        id: Integer,
+        number: Integer,
+        title: String,
+        description: String?,
+        draft: bool,
+        state: String,
+        url: String,
+        user: String,
+        created_at: String,
+        updated_at: String,
+        merged_at: String?
+      }
+
+      type git_tag = { name: String, commit_sha: String }
+
+      type git_release = {
+        id: Integer,
+        name: String,
+        tag_name: String,
+        description: String,
+        prerelease: bool,
+        url: String,
+        created_at: String,
+        released_at: String
+      }
+
+      type git_branch = { name: String, commit_sha: String, protected: bool }
+
+      type metadata = { next: String? }
+
+      def repos: (?Hash[Symbol, untyped] params) -> { data: Array[git_repo], metadata: metadata }
+      def pulls: (String repo_name, ?Hash[Symbol, untyped] params) -> { data: Array[git_pull], metadata: metadata }
+      def tags: (String repo_name, ?Hash[Symbol, untyped] params) -> { data: Array[git_tag], metadata: metadata }
+      def releases: (String repo_name, ?Hash[Symbol, untyped] params) -> { data: Array[git_release], metadata: metadata }
+      def branches: (String repo_name, ?Hash[Symbol, untyped] params) -> { data: Array[git_branch], metadata: metadata }
+    end
+  end
+end

data/sig/bundleup/unify/ticketing.rbs

@@ -0,0 +1,19 @@
+module BundleUp
+  module Unify
+    class Ticketing < Base
+      type ticketing_ticket = {
+        id: String,
+        title: String,
+        status: String,
+        url: String,
+        description: String?,
+        created_at: String,
+        updated_at: String
+      }
+
+      type metadata = { next: String? }
+
+      def issues: (?Hash[Symbol, untyped] params) -> { data: Array[ticketing_ticket], metadata: metadata }
+    end
+  end
+end

data/sig/bundleup/unify.rbs

@@ -0,0 +1,16 @@
+module BundleUp
+  module Unify
+    class Client
+      attr_reader api_key: String
+      attr_reader connection_id: String
+
+      def initialize: (String api_key, String connection_id) -> void
+
+      def chat: () -> Chat
+      def git: () -> Git
+      def pm: () -> PM
+      def crm: () -> CRM
+      def drive: () -> Drive
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bundleup-sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.4.0
 platform: ruby
 authors:
 - BundleUp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-28 00:00:00.000000000 Z
+date: 2026-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.23'
 - !ruby/object:Gem::Dependency
   name: rubocop-rake
   requirement: !ruby/object:Gem::Requirement
@@ -140,6 +168,7 @@ files:
 - README.md
 - lib/bundleup.rb
 - lib/bundleup/client.rb
+- lib/bundleup/mcp.rb
 - lib/bundleup/proxy.rb
 - lib/bundleup/resources/base.rb
 - lib/bundleup/resources/connection.rb
@@ -148,9 +177,19 @@ files:
 - lib/bundleup/unify.rb
 - lib/bundleup/unify/base.rb
 - lib/bundleup/unify/chat.rb
+- lib/bundleup/unify/crm.rb
+- lib/bundleup/unify/drive.rb
 - lib/bundleup/unify/git.rb
-- lib/bundleup/unify/pm.rb
+- lib/bundleup/unify/mcp.rb
+- lib/bundleup/unify/ticketing.rb
 - lib/bundleup/version.rb
+- sig/bundleup/unify.rbs
+- sig/bundleup/unify/base.rbs
+- sig/bundleup/unify/chat.rbs
+- sig/bundleup/unify/crm.rbs
+- sig/bundleup/unify/drive.rbs
+- sig/bundleup/unify/git.rbs
+- sig/bundleup/unify/ticketing.rbs
 homepage: https://github.com/bundleup/bundleup-sdk-ruby
 licenses:
 - MIT

data/lib/bundleup/unify/pm.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module BundleUp
-  module Unify
-    # Client for project management Unify endpoints.
-    class PM < Base
-      # Fetches issues from the connected project management tool.
-      def issues(params = {})
-        response = connection.get('pm/issues') do |req|
-          req.params = params
-        end
-
-        raise "Failed to fetch pm/issues: #{response.status}" unless response.success?
-
-        response.body
-      end
-    end
-  end
-end