The msc-tools leverage an existing obelisk server. If you wish to know more about obelisk or run your own see the Obelisk page. During installation the script will prompt you if you have one. If not you can come back later and update your ~/.sx.cfg file with the correct details.

Need a server? Try checking UN Systems wiki Note: At present most of the listed servers seem to have issues except

Tested Environments

The installation utility and all components have been tested in the following environments:

  • ubuntu-server-13.10 ( 32 | 64 )

Installing (auto)

An installation script has been provided that automates the installation process. It will prompt for obelisk server details and can be run with the following commands

git clone
cd install-msc
sudo bash

Optionally you can provide the obelisk server details on the cli

sudo bash -os tcp://

Installing (manual)

If you want to manually install all of the components you can do so with the following commands.

#Update the apt-get packages
sudo apt-get update

#install required supporting packages:
sudo apt-get -y install git python-simplejson python-git python-pip
sudo apt-get -y install make
sudo apt-get -y install git build-essential autoconf libtool libboost-all-dev pkg-config libcurl4-openssl-dev libleveldb-dev libzmq-dev libconfig++-dev libncurses5-dev
sudo pip install -r pip.packages

#Install SX using the modified installation script
#Note, this script installs specific revisions of the sx components known to work with mastercoin-tools
sudo bash

#Download the mastercoin-tools
git clone

#copy the scripts and wrapper for mastercoin tools to the mastercoin-tools directory
cp install-msc/res/ mastercoin-tools/
cp install-msc/scripts/* mastercoin-tools/

#update ~/.sx.cfg with an obelisk server details
# ~/.sx.cfg Sample file.
#service = "tcp://"

#create the mastercoin tools data directory
mkdir -p /var/lib/mastercoin-tools

#bootstrap files needed to start the parsing engine
tar xzf install-msc/res/bootstrap.tgz -C /var/lib/mastercoin-tools

#Mastercoin-tools directory needs to have permissions set to the user who will run it
sudo chown -R `logname`:`logname` mastercoin-tools
sudo chown -R `logname`:`logname`  /var/lib/mastercoin-tools