A
Atlas
...
Back to AI Coding
A

Atlas Forms + Claude

Create and manage forms directly from Claude Code with the Atlas MCP server, or use Claude.ai with pasted context.

MCP ServerClaude.aiClaude Code

Method 1: MCP Server

Recommended

The best experience. Claude Code gets MCP tools to create projects and forms, view recent submissions, and set up localhost testing, all through conversation.

1

Create an account

Sign up for Atlas Forms. You don't need to copy an API key.

2

Add the MCP server to Claude Code

Run this once in your terminal.

Terminal
$claude mcp add atlas-forms -- npx -y https://atlasforms.app/dl/atlasforms-mcp-0.1.3.tgz

Using Claude Desktop or another MCP client? Add this to its MCP config instead:

MCP config
{
  "mcpServers": {
    "atlas-forms": {
      "command": "npx",
      "args": ["-y", "https://atlasforms.app/dl/atlasforms-mcp-0.1.3.tgz"]
    }
  }
}
3

Sign in from Claude

Ask Claude to log in to Atlas Forms. It calls the atlas_login tool and gives you a link; approve the login in your browser.

Terminal
$claude
✓ MCP server "atlas-forms" connected

You can also sign in from your terminal with atlas login. Full agent setup guide: atlasforms.app/llms/agent-setup.txt

4

Start building

Ask Claude to create forms, view submissions, or get endpoint URLs.

Claude Code
claude-sonnet-4-20250514
>
Create a newsletter signup form for my blog
*[atlas_create_form]
✓Created form "Newsletter Signup"

Your form endpoint is ready:

https://atlasforms.app/f/nl_abc123

Here's the HTML you can add to your blog:

html
<form action="https://atlasforms.app/f/nl_abc123" method="POST">
  <input type="email" name="email" placeholder="your@email.com" required>
  <button type="submit">Subscribe</button>
</form>
💡
Claude can also set up localhost testing for you. Ask: "Set up my form for local development"

Method 2: Paste Context

Claude.ai

For Claude.ai or the API. Paste the Atlas context at the start of your conversation so Claude understands how to use the API.

1

Copy the context

This gives Claude everything it needs to know about Atlas Forms.

Atlas Forms Context
# Atlas Forms

Form backend API. Submit forms to: https://atlasforms.app/f/{form_id}
Agent setup guide: https://atlasforms.app/llms/agent-setup.txt

## Quick Start
1. Create account at https://atlasforms.app
2. Create a project (dashboard, or `atlas projects create`)
3. Create a form → get endpoint URL
4. Point your HTML form action to the endpoint

## API Endpoints
- POST /f/{form_id} - Submit form (accepts JSON, form-data)
- GET /api/v1/submissions - List submissions
- POST /api/v1/projects/{id}/forms - Create form

## Authentication
Form endpoints (/f/{form_id}) need no auth.
API calls: Authorization: Bearer <token> (from device login: `atlas login`)

## HTML Example
<form action="https://atlasforms.app/f/{form_id}" method="POST">
  <input name="email" type="email" required>
  <button type="submit">Submit</button>
</form>

Full documentation available at atlasforms.app/llms.txt

2

Start your conversation

Paste the context, then describe what you want to build.

U

Your message:

Here's info about Atlas Forms: [paste context]

I need a contact form for my portfolio. Can you give me the HTML and explain how to set it up?
3

Get your code

Claude will generate HTML and guide you through setup.

I'll help you set up a contact form. First, you'll need to:

  1. Create an account at atlasforms.app
  2. Create a new project and form
  3. Copy your form endpoint URL

Here's the HTML for your form:

💡
Never paste API keys or tokens into a chat. If you want Claude to manage forms for you, use the MCP server (Method 1), which signs in through your browser.

Method 3: CLI + Claude

Hybrid

Use the Atlas CLI to manage forms from your terminal, then ask Claude to help with integration code.

1

Install the CLI

Terminal
$npm install -g https://atlasforms.app/dl/atlasforms-cli-0.1.3.tgz
2

Create a form

Terminal
$atlas login
✓ Logged in as you@example.com
$atlas projects create "My Site"
✓ Created project "My Site" (proj_123)
$atlas forms create "Contact Form" --project proj_123
✓ Created form "Contact Form"
Endpoint: https://atlasforms.app/f/abc123
3

Ask Claude for integration code

Share the endpoint with Claude and ask for framework-specific code.

Claude Code
claude-sonnet-4-20250514
>
I have an Atlas form at https://atlasforms.app/f/abc123. Write a React component that submits to it with loading states.

I'll create a React contact form component with loading and success states:

tsx
export function ContactForm() {
  const [status, setStatus] = useState<'idle' | 'loading' | 'success'>('idle')

  async function handleSubmit(e: FormEvent) {
    e.preventDefault()
    setStatus('loading')

    const form = e.target as HTMLFormElement
    const data = new FormData(form)

    await fetch('https://atlasforms.app/f/abc123', {
      method: 'POST',
      body: data
    })

    setStatus('success')
  }

  // ... rest of component
}

Available MCP Tools

When using the MCP server, Claude has access to these tools:

atlas_login

Start a browser sign-in

atlas_login_complete

Finish sign-in after you approve

atlas_list_projects

List all your projects

atlas_create_project

Create a new project

atlas_list_forms

List forms in a project

atlas_create_form

Create a new form endpoint

atlas_get_submissions

View recent submissions

atlas_get_form_endpoint

Get endpoint URL and examples

atlas_sandbox_status

Check localhost testing setup

atlas_sandbox_register_ip

Register IP for testing

atlas_sandbox_add_ip

Allow another IP for testing

atlas_sandbox_generate_key

Generate a sandbox test key

Example Prompts

Try these prompts with Claude Code (MCP) or Claude.ai (with context):

“Create a contact form for my website with name, email, and message”

Creates a new form and provides HTML code

“Set up a newsletter signup that redirects to https://example.com/thank-you after submission”

Creates form with custom redirect URL

“Show me my last 10 contact form submissions”

Retrieves and displays recent submissions

“Create a file upload form for client documents”

Creates a form endpoint and HTML with a file input (uploads are accepted on every plan)

“Set up my contact form for localhost testing”

Configures sandbox mode and registers your IP

Ready to start?

Create your free Atlas account, add the MCP server, and start building forms with Claude.