Quick Start

Add OACP to an Android app with one dependency, two asset files, and one receiver.

oacp-android is the Android SDK for the Open App Capability Protocol. It gives you the provider, parameter parsing, and result helpers so you only need to implement your app logic.

MCP gave AI agents tools on servers. OACP gives AI assistants capabilities inside mobile apps.

1. Add the dependency

Use the local AAR for now. The planned Maven coordinates exist in the SDK README, but Maven Central publishing is not the installed path today.

Download oacp-android-release.aar from the latest release, copy it to app/libs/, then:

2. Create assets/oacp.json

Declare the action your app exposes:

3. Create assets/OACP.md

Add short semantic context:

4. Handle the action and register the receiver

The SDK auto-registers the ContentProvider via manifest merger. Once the receiver is in place, the app is discoverable by Hark and other OACP-compatible assistants.

5. Verify with adb

You can test the action before installing an assistant:

Requirements

• Android minSdk 21+
• Kotlin or Java
• Android app module with access to assets/ and AndroidManifest.xml