Cofounder CLI

Incorporate

Form the company as a US legal entity through Ramp — connect or apply, pick a state, and submit the paid filing.

Cofounder files the company's formation through Ramp. The founder signs in to Ramp and verifies their identity on Ramp's own pages; your agent handles the rest of the application and the filing.

Connect Ramp

Start with cofounder company incorporation get — it reports whether Ramp is connected and what to run next.

MCPCLIAPI
company_incorporation_getcofounder company incorporation getGET /cofounder-cli/v1/company/incorporation
company_incorporation_connectcofounder company incorporate connect, cofounder company incorporation connectPOST /cofounder-cli/v1/company/incorporation/connect
company_incorporation_applications_createcofounder company incorporation applications create --first-name <first> --last-name <last>POST /cofounder-cli/v1/company/incorporation/applications

Already have a Ramp account? incorporate connect opens the sign-in. New to Ramp? applications create starts an application and emails the signed-in founder an invite.

Fill in the application

Read the application before asking the founder anything, so you don't ask for details it already has. Updates change only the fields you pass.

MCPCLIAPI
—cofounder company incorporation applications getGET /cofounder-cli/v1/company/incorporation/applications
—cofounder company incorporation applications update --business <json> --data-source-summary <text> --user-prompt <text>PATCH /cofounder-cli/v1/company/incorporation/applications

Every change to the application takes --data-source-summary (where the facts came from, such as "legal name confirmed by the founder") and --user-prompt (what the founder asked for). SSN and passport details are refused here — the founder enters them only on Ramp's page.

Track the application

MCPCLIAPI
company_incorporation_progress_getcofounder company incorporation progress getGET /cofounder-cli/v1/company/incorporation/progress
company_incorporation_documents_listcofounder company incorporation documents listGET /cofounder-cli/v1/company/incorporation/documents

progress returns a deep link whenever Ramp needs the founder — identity details such as SSN are only ever entered there.

Ramp may come back with follow-up questions. Each one says who should answer it: answer the ones marked AGENT yourself, and hand the founder the deep link for the rest.

MCPCLIAPI
—cofounder company incorporation applications followups listGET /cofounder-cli/v1/company/incorporation/applications/followups
—cofounder company incorporation applications followups update --followup-id <id> --response-text <text> --data-source-summary <text> --user-prompt <text>PATCH /cofounder-cli/v1/company/incorporation/applications/followups/{followup_id}
—cofounder company incorporation applications followups submit --data-source-summary <text> --user-prompt <text>POST /cofounder-cli/v1/company/incorporation/applications/followups/submit
—cofounder company incorporation applications documents listGET /cofounder-cli/v1/company/incorporation/applications/documents
—cofounder company incorporation applications documents delete --document-id <id> --data-source-summary <text> --user-prompt <text>DELETE /cofounder-cli/v1/company/incorporation/applications/documents/{document_id}

Send the answers with followups submit once followups list says the application is ready and the founder has said yes. Check the uploaded documents before adding another, and delete a duplicate or wrong upload only after the founder confirms.

File

Pick the state and industry, then submit:

cofounder company incorporation options list --lookup states
cofounder company incorporation options list --lookup industries --industry-search "software"

cofounder company incorporate submit takes the state, NAICS code, a short description, three or more --name-option candidates, and a mailing address. It spends money: it prompts to confirm the filing fee, or pass --yes with --snapshot <fee-cents> set to the filing_fee_cents that options list --lookup states quoted. On MCP, company_incorporation_submit carries the same fee confirmation. The longer form, cofounder company incorporation submit --confirm-fee --filing-fee-cents <cents> ..., takes the mailing address as one JSON value. If Ramp's fee has changed since you quoted it, the filing is rejected rather than charged.

After filing, cofounder company incorporation registration-status get follows the government filing and shows the EIN once it's issued (company_incorporation_registration_status_get on MCP).