Tidy ACTION
Create Address
Creates a new address in Tidy. See the documentation(https://help.tidy.com/create-an-address)
- Action
- Writes data
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Tidy account once, then configure and run Create Address from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "tidy-create-address",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
tidy: { authProvisionId: "apn_xxxxxxx" },
address: "Street Address",
unit: "Unit",
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "tidy-create-address",
"configured_props": {
"tidy": { "authProvisionId": "apn_xxxxxxx" },
"address": "Street Address",
"unit": "Unit"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "tidy",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "tidy-create-address",
arguments: {
address: "Street Address",
unit: "Unit",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
address Street Address | string | Street number and name. Commonly referred to as address1 Required |
unit Unit | string | Any Apt/Unit/etc. Commonly referred to as address2 Optional |
postalCode Postal Code | string | Valid Postal Code Required |
city City | string | City Required |
countryCode Country Code | string | Valid 2 Digit Country Code (US by default). Here is a list of valid codes: https://www.iban.com/country-codes Optional |
addressName Address Name | string | Address Name Optional |
paidParking Paid Parking | boolean | Does parking require an upfront payment? Required |
parkingSpot Parking Spot | string | Describe the parking spot for the Provider Required |
parkingNotes Parking Notes | string | Notes about parking Required |
maxParkingCost Max Parking Cost | integer | If paying with card, what is the maximum amount the Provider can get automatic approval? Reimbursements over this amount will require manual verification of reimbursement. This field does not accept decimals, so the value is in "cents" in the US. For example: you would want to enter $5.00 max as 500. Optional |
parkingPayWith Parking Pay With | string | How is the Client going to cover parking reimbursement? Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- tidy-create-address
- Version
- 0.0.2
- App
- Tidy
- Authentication
- API key
- Read-only
- No
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗