Getting Started

Install

pip install mca2-sdk

Get your credentials

You'll need a clientId, clientSecret, and audience from your MCA Suite account representative before you can authenticate. These are issued out-of-band -- there's no self-serve endpoint to create them.

Warning

The sandbox host (https://testapi.mcasuite.co) is what both SDKs default to. No production host has been confirmed yet -- pass base_url (Python) / baseUrl (TypeScript) explicitly once one is available.

Authentication

Every API call needs a bearer token, obtained by exchanging your client credentials at POST /oauth/token:

Field	Type	Description
clientId*	string	Issued to you by MCA Suite.
clientSecret*	string	Issued to you by MCA Suite. Keep this secret.
audience*	string	Issued to you by MCA Suite.
grantType*	string	Always "client_credentials".

The response includes an accessToken valid for up to ~10 minutes. Both SDKs fetch and cache this token automatically and refresh it before it expires -- you never need to call /oauth/token yourself.

Initialize the client

from mca2_sdk import MCA2Client
 
client = MCA2Client(
    client_id="YOUR_CLIENT_ID",
    client_secret="YOUR_CLIENT_SECRET",
    audience="YOUR_AUDIENCE",
)

Make your first call

result = client.leads.add(
    company_name="Acme Inc",
    company_dba="Acme",
    first_name="Jane",
)
print(result.id, result.success)

Next: read the Python SDK guide or TypeScript SDK guide, or jump straight to the API reference.