POST https://withpersona.com/api/v1/reports with body {data:{type:'report/business-kyb', attributes:{reference_id:'your-ref', fields:{business_name:'Acme Corp', business_ein:'YOUR_EIN', address_street:'123 Main St', address_city:'Springfield', address_state:'IL'}}}}
Poll GET https://withpersona.com/api/v1/reports/{report-id} until attributes.status changes from 'pending' to 'ready'
Parse attributes.result.business_registration for SOS status, formation date, registered state, and registered agent
Inspect attributes.result.associated_people for UBO names, ownership percentages, and individual verification statuses
Check attributes.result.watchlists for OFAC and PEP hits across business and all listed owners
Store report-id with your business record for future re-runs or audit retrieval
Known gotchas
Report type names are versioned and may change; always confirm available report types in your Persona environment via GET /api/v1/report-templates before hardcoding
EIN is optional but significantly improves match rates; without it, name-address matching alone can return multiple candidate businesses
Persona report results for businesses formed in states with limited online SOS data may return partial or unverifiable registration details
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp