Bitcoin MCP Server

What is Bitcoin MCP Server?

Bitcoin MCP Server implements the Model Context Protocol (MCP) to expose Bitcoin price information. It is a Java-based server intended for developers building MCP-compatible applications that need to query live Bitcoin price data by fiat currency.

How to use Bitcoin MCP Server?

Build the server with mvn clean package to produce a JAR file. The server uses STDIO transport and is launched automatically by an MCP client. A test client (ClientSTDIO) is included; run it with mvn exec:java -Dexec.classpathScope=test -Dexec.mainClass="za.sk.bitconmcp.ClientSTDIO". The server JAR path can be set via the system property mcp.server.jar.path or the environment variable MCP_SERVER_JAR_PATH.

Key features of Bitcoin MCP Server

• Single tool: getBitcoinProceByCurrency (accepts currency code)
• STDIO-based transport (no network ports required)
• Java / Maven project (portable JAR)
• Test client demonstrates connection, tool listing, and invocation
• Built for integration with MCP-aware AI agents

Use cases of Bitcoin MCP Server

• AI assistant that fetches current Bitcoin price in USD
• Quick prototyping of MCP tool servers
• Integrating Bitcoin price lookup into an MCP-hosted workflow
• Developer learning exercise for MCP STDIO pattern

FAQ from Bitcoin MCP Server

How do I build the server?

Run mvn clean package from the project root. This creates the JAR at target/bitcoinmcp-0.0.1-SNAPSHOT.jar.

How do I configure the server JAR file path?

Set the system property mcp.server.jar.path or the environment variable MCP_SERVER_JAR_PATH to the absolute or relative path of the JAR. If neither is set, the client defaults to target/bitcoinmcp-0.0.1-SNAPSHOT.jar in the current directory.

What transport does the server use?

The server communicates via standard input/output (STDIO), as configured in application.yaml. No network ports are exposed.

What tool does the server provide?

One tool is implemented: getBitcoinProceByCurrency. The test client calls it with USD as the currency parameter.

I see “MCP server JAR file not found” – what should I check?

Ensure you have built the project (mvn clean package), are running the client from the correct directory, and have specified the JAR path correctly via system property, environment variable, or default location.